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INTRODUCTION 1 



HOW TO USE THIS MANUAL 

The Apple PaBcal syscem Is Intended to run on Che Apple II and Apple 1|. 
Plus cotnputera. The Hyattiin requires A8K bytes of inBCalled DM-niory, one 
or mote Apple Disk II dluk drlvee and the Apple Lanfiuaee Syatem. 
luBtallatlon proceduros and other Instructions for Che requited 
Language Card are covered In the small Appl^ Laagimge System manual, 
which you should read before beginning this cnsnual- 



The above aynbol appears Chroughout thle manual. Its pucpose Is to 
alert you to an unusual feature of the Apple Pascal operating system- 



GEHING STARTED 

Tbe Apple Pascal UperaCing Syatem Reference t^nual and the lanauage 
deference manual for Che prograinmjng language you will use with the 
A^'Pple Pascal nporatina system are most definitely not Intended for 
beginners at usinfi computers and Pascal- However, each language 
reference manual for use with the Apple Pascal nperatlng system 
Includes easily followe^J chapters to help you begin using Che operating 
systein with chat proararamlng LauBuage. Read Cheae chapters in the 
programming language reference Dkanual FIHST- They will help intrflduce 
you to the Apple Pascal operaclng syGteTn and help you get the "feel'' of 
things, after which tht more technical material in the Apple Paacsl 
UpecfltloB Syatem Reference Manual will be easier Co follow- 



THE OPERATING SYSTEM 

The Apple Pascal system Includes a Filer for handling diak files, a 
powerful text Editor for writing programs, a Pascal Compiler to converi 
your programs Into executable P-cude, a 6502 Assembler Co convert 
flflsembly-language routines Into machine -language code, and a Linker tti 
combine other routines Into your program- These make up the Apple 
Pascal operating system; they are not part of the Pascal programming 
language Itself, but they help you to write, store, and eKecuCe your 
programs. In Chapters 2 through 7 of this manual, you will find 
detailed discussions of each portion o£ the operating system- The 
"coimnand tree" shoi^n on the inside back cower will help you find your 
way around in the varlaua levels of the operating system- 






i 






In addition Co Che main operating system, there are also various utility 
programs which le^ you forTnat new diskettes, put routines inno a system 
lihraryt and configure your system to tun with most eKcernal Cenninals- 
Thesc utility progranks and others are discussed in Chapter S* 

In each chapter about Che operating system, a special "Diskfiles" 
section Cella you which Language System diskette to put In each disk 
drive before atteiptlng to use that portion of the operating system- 
These "PlskfUes" sections can be a great help, especially for cme-dlflk- 
drlve systenis, where use of the Language System diskettes may seem 
confusing, at first- 

In general, each chapter in this manual containa a detailed diHcussion 
of a particular portion of the Apple Pascal operating system, followed 
by a simiJtiary of tlie information in that chapter- Read the main body 
of the chapter the first time, and whenever you need detailed 
information about that topli!* Use Che aammary Eor a quick reference, 
when you just need to he reminded of information you already know. 

An even briefer Bununary of all the operating system nonraands appears 
la Che last appendix, at the end of this manuals 



THE LANGUAGE 

This manual contains some iaformacion abouc using the Apple Psacal 
operating system •'ith the Apple Pascal programming language and with 

b59'Z asEembiy language- However* it does not attempt to describe or 
explain the details of any programming language^ For further 
Information about any of the programming languages used with the Apple 
Pascal operating system, you should consult the reference inanuals foe 

the ind i v I dual Xangua ges -- 



i ^ 
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Chapter 1 
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ChapEei B 
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Appendix C 

AppendJx D 
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INTKOnUCTIQN 

COMMAND level: Co eelect Filing, Editing, CompiUna, 

Assembling, Linking, Running, etc- 
FILER: handles disk and other files 
EDITOR: for writing and changing text Ellea 
compiles; canverta Fascdl text Into P-code 
ASSEMBLER: converts assembly-language text into 6502 

mac h 1 n e -langu a ge 
LINKEH: tJea external routines Into your prograins 
UTILITIES: disk formaCtec, Installlne routines Into 

system library, Gjcternal terminal aetup, ate- 

Architecture oE the P-machlne 

Operation of the P-machlne 

file famiata 

TABLES of useful Informatlnn 

SUHMAAY of all opecdtlng system canrnteiidB 
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THE OPERATING SYSTEM 



The Apple Paacai system described in thifi document Is Intended to run 

an the Apple 11 and Apple 11-Piua coinpmiers. The ayflteif, requires iSK 

bytea of installed memocy, one at more i^ple Disk II disk drives And 
cne Aijple Language isystem* 

While tl-ie ayateni is pcimarUy intended Cci use the Apple keyboard and the 
usual TV or mt-nltor, an external CKT terminal such aa the Soroc IQ 120 
can act as Lhc CONSOLE devii:e, cqnnecled to Che Apple through a 
Qiodlfled AppU Communlcatiofls Interface Cacd. With such an external 
tccrainal. it htcomea possible to do teat and program editing in upper 
and lower tase on a large m characCers by 2A lines) screen. For most 
prDgramdilng purpoaeB. an eicternal temlnal la coo^letely unnecesaary. 



^ 



Tbia Dianual is uritten BpeciflCalLy far using Che Apple Pascal aperating 
ayatem with the Apple Pascal pcoarammlng language and coraptler. II you 
^re using the Apple Pascal operating aystein with any other prograraninB 
language, you must first read tliflt language's reference tnaniial for 
apecial InaCcuctions about using this operating system. 



THE SCREEN DISPLAY 

The Apple Pascal operating system always uses a display that la 80 
characters wide- The Apple's i0-character acreen normally ahows only 
Che lefcnioac 4* characters fthe left "p3B*=") "f the Pascal diap lay, 
whl<:h la suttJclent for loosc applicatlona- To see the rightniDat hjfi 
charactera (the right "page") of the display, type A while folding 
down the CThL key (we will iisually call this "CTftL-A")- Pre^a CTRL-A 
again to fio back to che left "p^S^" of the display. When the white 
square cursor is on the screen, you cau «mke the Apple screen scroll 
right and IcEc to "follow" the curaor automatlcalLy . by preaaing CTW- 
Z. (JXRL-A (like many other coiomands) cancels CTRL-Z- 



THE PROMPT LINE 

At ™ac times you will see a "prompt line" which ahowa the command 
options available to you at the moment. Uere are 2 examples: 

COMMAND: E(DTT, RClW. HILE, C(»1F, L(INK. XtEQJTE, ACSSHM. P(EBUG, ? 
COMWAND: E(ClT, R(llN, F(ILE. CtOMP, LflN 

Note: In general, prompt lines throughout Chla maaual are given in two 

somewhat different forms. The longer, more ccmplete jo-;"; /« =^he 

prompt line aa it might appear on an externsl terminal which can 

display an B0-character line. The shorter form Is the prompt line as 

6 APPLE PASCAL OPERATING SYSTEM 
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it will appear on the Apple's ft0-tharflcter montCor or TV screen. In a 
ftw cases, the order of the options shown in the long form differs 
from that in the shorter forra. Many prompt lines end in a series of 
letters and nunbers enclosed in square brackets. These indicate Che 
version number of che portion of the program with which you are 
working. 

In response to this prompt lino, you can use the Editor, Pjin a 

program, operate the Filer, or choose any of several other options, 

Just by typing a single letter. Typing E , for example, will invoke 
the Editor- 

When you do invoke the Editor (or exercise almost any of the other 
optionaj , ytm "ill usually be shown another prompt line that allows you 
Co choose command options appropriate to that activity. The "coimaand 
tree" shown on the inside hack cover of this manual will help you find 
your ^ay arouncL in the various levels of the operating ayatem. 

SomeliineE the prompt line contains too many options to fit on the 
screen's two Ap-character "pages". If this happens, a question 
mark f 7 J may appear at the end o£ the prompt line. Whether or not 
the ? appears in the prompt line, typing ? will cause any 

remaining command options to be displayed* 

On aorae occasions, you will have to type a name or other information 
longer than a single character. These entries are terminated by 
pressing the RETURN key. If you make a typing mistake before pressing 
the RETLfRN key, you can backspace over Che error by pressing the 
backspace key [left-pointing arrow key) near the right side of the 
keyboard. Tvptng a CTRL^X will erase all the characters you have Just 
typed. On a tsnninal such ab the Soroc IQ 120, a HUB key (or another 
key) Diay iJo this quick-erase. If you wish to get cid of the question 
altogether, juat press the RETLFRN key. 



DISKFILES NEEDED FOR BOOTING 

The following diskflle is needed for the first stage of a "cold boot" 
of the systemi 



St ST Ol, APPLE 



(in Che boot drlvei requiredj 



The system Is "cold hooted" every time the Apple's power Is turned on, 
or when the Hfalt option la selected from Che COMMAND prompt line. 
The file SYSTBM-APPLE contains the interpreter, which allows compiled 
P-code to be executed by Apple's 65432 processor. The interpreter Is 
loaded into the Language Cani's memory, and write-protected there. It 
does not have to be re-loaded until the next cold boat of the system- 
This file is normally found on dlsketle APPLEl: and also on diskette 
APPLET:, so either of those diskettes may be placed in the boot drive 
(volume 04:) to begin a cold boot. 
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The following dlskfllea are needed to complete a "cold boot" oi the 
flyatem, or to effect a "warm boot" of the aysten: 



SYSTEM. PASCAL 
SYSTEM- MI SCINFO 



fin the boot drive; requited) 
(In the boot drive; lequlced) 



The aystem is "warra booted" when the Apple's RESET key Ib pressed, 
when Che I£nJt±altze option ta selected fcoa the COMMAND pcompt line, 
or vhen any systet™ error causes the ayaceoi to be re-lnl tiallzed (re- 
booted)- Thefie two flies are normalLy found on diskette APPLES: and 
alea on diskette APFLEti, so either of those diskettes may be placed 
in the boot drive {volume ifU:) to effect a warm boot, or to complete a 
cold boot. The diskette which supplies these two files becomea the 
system's "boot diskette". 

In general then, IL Is essieEt to cold-boot any syateo With diskette 
APPLEl: in the hoot drive. Once this cold bouL is complete, ooe-drlve 
ugers inay wish to switch to APPI-S0: as their sygtero diskette, by 
plfldlnn APPLE0; in the boot drive and pressinfi the RESET key. A warm 
boot may he carried out if either diskette APPLE«! or diskette APPLEl: 
is in the boot drive. 

Note: If APPLE3: is used to acart a cold boot, no message appears on 
the screen. When all action ceases, put APPLEfl: or APPLEl; in the 
boot drive and press the HESET key ta complete booting. 



MAKING A TURNKEY SYSTEM 



The Apple Pascal syaten allows you to set up a turnkey system, which 
Will automatically begin running a particular program when the Apple ie 
turned on. To set up your Apple as a turnkey system, tirst raake a copy 
of diskette APPLEl: and use the Filer's Cthan^e conmand to change the 
copy's name to something you will recognize. For example, you might 
naoe this diskette TUkNKEY: . Now TCransfer a copy of your profirnra 
codefile onto the turnkey diskette, giving this new copy of your 
program the filename SYSTEM. STAST UP - Make sure your turnkey diskette 
contains the following flies: 



SVSTEf'l. APPLE 
SYSTEM. PASCAL 
SYSTEM.MISCthFO 
SYSTEM. LIBRARY 
SYSTEM. CKARSKT 
SYfiTfi^J. STARTUP 



(if needed by your STARTUP program) 
(if needed by your STARTUP program) 



6^ 



You may remove any other files Esuch as SYSTEM-FILER, SYSTEM.EDITOR, 
and SYSTEM-SYNTAX ) If yo\i need more space on the diskette for your 

program's files- 

To mn yuur turnkey ptograait put the turnkey diskette in the boot drive 
and turn on the Apple's power. Soon, and with no further intervention, 
SVSTOI-^TAHIUP is a^ecuted- Thereafter, SYSTEM- SI AHTLtP will also be 
executed <^ach time the system is re-booted, re-initialized, or the KhJit. 

key is ptessed- 
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THE WORKFILE 

The Apple Pascal system makea frequent use of a "WrkM U"- The 
vorkflle is a special "default flU" ^sed during the development of a 
program or a piece of text- Vou can Edit. Save and Update, Coinpl le or 
Assemble, Link and Ron the workflle as often as you wish, without 
having to specify the name of the workfUe for each operation* These 
operations automatically flssunie you are referring to the workfEle on 
the boot diskette. If there Is a workfile currently stored on that 
diskette, and if that diskette can he found in one of the disk drives. 
The boot diskette la the diskette that was in the boot drive, volume 
ffi; Cslot 6> drlje 1), the last time the system was booted. 

The HystQci always atorea the workfile on the boot diskette, uaing the 
BQQie filename: SYSTEM. WRK - This is handy for you find the system, as 
it makes it easy to find the current file on which you are working- 
For tEjiit, the stored workf i le's full name is always SYSTEM -WHK- TEXT - 
For prograiiis, the stored workfile often consists of both the text 
version (SYSTGK-WRH-TEXT) ond the con^iled or assembled version 
iaYSTEH-iVKK.COUG) which are anved and retrieved together- Individual 
coUBianda auCoinstically use the correct version of the workfile- 

It is also possible to designate any other filename as the next 
workfile ualna the Filer's Gfet coinmand. This command removes any 
old files named SYSTEM-WTtJl from the boot diskette, hut does NOT create 
fl new tiLe named SYSTEM, URK - Instead, the neat time any command 
(auch as Edit, Compile, or Run! attempts to use the worfcfJle, the file 
designated by Gfet is used- 
Only one workfile is allowed at any one time- This Js no limitation, 
since it is easy to Save your current workfile under a filename of 
your choosing, so that you can create another workfile. And it is 
Just as easy to bring a saved file hack to be your new workfile. 
These Operations are covered in this manual's chapter THE E'LLEP- 



COMMANDS USABLE AT ALL LEVELS 



Certain system commands can be eseouted at ANY level of the operating 
syatem, regardless of which option Is in force at the moment- Vou 
have already been introduced to those affecting the screen, but there 
are others, as well- These omni-present comiiflndB ere listed belowi at 
no time do these cocnnands appear on any prompt line. Note that the 
syateni will detect a typed command only when the next input or output 
Operation begins- 



CTRL-A 



Shows tlie other AO-character "page" of the Apple Pascal ay^tcm s 

ao-character display, until the next CTHL-A- 



COMMAND LEVEL 9 



CTRL-Z 

InitiHtea "Auto-f ol Icu^' made: the screen hccoIIb tight and left to 
follov Ehe cursor. Cancelled by CTRL-A and many othet coQtiDands. 



CTRL- @ 

Causes current prDgram to be intettupted and Issues the xetmage 
"PHOGUM iNTEItRUPTED BT USER." Presa spacebar Co telolttallBe the 
Byfiten* 

CTRL-F 

CauECB flubaequent pcagram output ta be flushed* The pEDgtam continuea 
to run, but its output is not sent Co the scte^n nc the printer- 
Cancelled by Che neKC CTKL-F . 




Card by a warm toot, so the diskette file SYSTEH. APPLE need not be 
present. To accompliah a warra boot, either dtaketce APPLEl: or 
diskette AFFLEIZ^: must be in the boot drive, voluine M - 

USING THE COMMAND LEVEL 

The Coranand level of the Apple Pascal syfltem ^h reached whenever yoo 
boot or react the system (by any means}, when Che sysCein re- 
Inltl^iiJsea Itself afLer a fatal run-time trror, when you i}init the 
IvdJtor or the Filter, and when you finish CtorapJIinB, Atasembllna, 
[,(JnkLTig, XfecuLlng, or R(unninB any utility or other progrsin. You 
have already seen the CUHMAND pronpl line: 

COMMANU: E{DIT, BCUN. F(1LE, CCOHP, LUNK, XfECUTE, AfSSEH, n(EHCG, 7 

Use CTRL-A to see the rest of the prompt line. After typing a ? , 
the renaJnlng Command options are fihown- 

COMHANU: UtSER RESTART, ICNITIALI^G, HIALT 



CTRL-S 

Stops any oo-Bolng operating system prOcesH or programn 
CTRL-S is typed, the proceaa continues* 



When the next 



POWER DOWN-AND-UP 

Turning tlie Apple's power switch off and tliun on again does a "cold 
boot" of the aystem, JuflC as if the system «ere being turned on for the 
first time. This comnand will stop any on-going process, at the 
expense of loelng whatever Is in the Apple's memory, l^en the system 
"hangs" (stops and does not respond to the keyboard, even when you 
press the EltSET key), this i^ojnmand will usually re-start the aysEem, 
After this command r you will have to repeat the entire normal startup 
procedure. The P-code interpreter in loaded Into the Language Card and 
wtitp-protectcd there, so Che file SYSTEM, APPLE must he on the diskette 
In Che boot drive, volume WA:. To acconpliah a cold boot, one-dls-k- 
drive byatems and mult Ip le-di sk-dri ^/e systems must both start with 
diskette AFPLEl: In the boot drive* 



RESET 

FresHlng the Apple's RESET key does a "warm hoot" of the aystein. This 
cofflDiand will stop almuat any ongoing process, at the expense of losing 
whatever Is In the Apple'ii meraocy. When the system "lianas'' (stops and 
does not respond to the keyhoatd), this command will usually re-start 
the system. The P-code Interjireter Is not re-loaded into the Language 



DISKFILES NEEDED 

The Apple Pascal operating ayatein is iraich too larjte a program to be 
kept eutlreiy in the Apple's mtmory all the time, Besldea, you use 
only a amall part of the operating aysteui at any given tfme. For this 
renHon, the operating system la broken into several fiitialler portions, 
and theae program portions are stored in separate dlskfHaa on the 
ayscen diskettes, under filenames such as SVSTEM, FILLR, SYSTEM- EDITOR, 
and SYSTEM. CUfEPlLER* Each option from the COtE^AND prompt line uses 
one or mure of these special dlskfllea. 

Before you specify a particular Copmiand option, you must first make 
sure that the dJskfttes needed by that portion of the operating ayatein 
are available- In most cases, the required dlskfJle is allowed to be 
on ANY diskette in any of your system's disk drives. The system Just 
goes through the diskettes in e-^ery drive until ft finds a file with 
the necessary filename. 

The workflle (SYSTEM, WKK- TEXT and SYSTEM,WRK.COOE) and Cbe Compiler's 
error-'PnieBsaiie file {SYSTEM, SYNTAX) will be found hy the syfltein ONLY If 
they are on the boot diskette- The boot diskette is the diskette that 
was in the boot drive, volurne OAz (slot 6, drive IJ, the last time the 
system was booted. T}ie aystera will naually look for the boot diskette 
in the boot drive first, but will also look In the other drives if 
necessary. 

The dlflkfltes SYSTEM, PASCAL and SYSTEM- L I BBtARY are usually accessed by 
going directly to thpir positions on the diskette in the hoot drlije, 
Uuring the booting process, the system notes the positions nf these 
two files on the hoot ijjskutte. Thereafter, whenever the system needs 
either of those files, it assumes that the diskette in the boot drive 
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fltlll contains the needed flleg In ejtflctlv the aame dJskette posJtiana 
occupied by chose fllea during Che laat baar- If the ayatem does not 
find the correct IfiformntJon at those diskette locatJong, the syscen 
may "hang" (stop respondific Cn the keybofltd}, and you will have to re- 
boot- If you change the contents or the position of either of these 
£JleE, you should RESET or Unitialize the svateoi tu let it discover 
the chajiBE- 

During program execution, the information In SYSTEM. LinilARY is 
accessed by its boot-time position in the boot drive. During Liukinr, 

however, the Linker Btarches for "SYSTEM- LIJiRARY by name, and will 
find it on the boot diskette in any drive. 



For information about enterlne the Cnmnand level via a "cold hoot" or 

via a "warm boot", see the section DISKFILES NEEDED FOR BOOTING, 
earlier in this chapter. The HyEtem ia "cold btioted" when tlse 
Apple's power is turned on, or when the Conanand option H(3l[ Is 
selected- T[ie ayatem ia "warra booted" when the Apple's [tESET key is 
preased, when the Command option l(nitialize ia selectsdj or when any 
hyatein error cbuseb the syeten to be re-Jnl tiallsted (re— booted)- 



The following diskflle is needed each tine the syetera returns to the 
Lomjoand level following the terrnlnatfon of say option or program; 



SYSTKH, PASCAL 



(boot diskette. In boot driven required) 



This file contains the Command levol portion of the operating syatern. 
The GysLeiii triLu to re-enter the Conmiand level after any program is 
terminated by ^(ulttJng any portion of the operating syafem, by 
reaching the END. of any option or any program that you are executing, 
or by any non-fatal execution error. 

When the system actenfpts to return to Command level it first checks to 
be auce the diskette In the boot drive is the i:orrcct boot diskette- 
If the diskette ia in the hoot drive, but does not have SYSTEM. PASCAL 
In the expected diskette locations, the system may "hang", and may not 
respond evt-n to the RESET key. In thia case, yuu will have to cold 
boot the system by turning the power off and then on 



Lng the p 
diakeCLe APPLEl! In the boot drive. 



len on again, uiEtli 



Each return to Command li^vcl must find the boot diskette in the boot 

drive. The eaaiedt way to accomplieh this Is to make sure your boot 

dlakeEEe la In the boot drive whenever a Command option or program is 

terniinated. If a return to Command level Ilnds the wrong diskette 

in the hoot drl^e, you will he prompted 

PUT IK APPLEl: 

(if APPLEl: Is your boot dlakette). The boot drTve will start again 
and again, until you press RESET or put the correct boot diskette In 
the boot drive. 
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"^The file SYSTEM. PASCAL la narmally found on dlakeCCe APPLE0: and also 

on dlEkette APPLEl: * However, you luuHt stick ulth one or the other 
JJtthe one which is your boot diskette) when leaving Che Command level 
2^Dd returning to It- To change from using one of theee diskettes to 
using the other ss your boot diskette, you should place the new 
d iskette In the boot drive and press the Apple's RESET key to re- 
lAoot. You should also re-boot Che system any time you move the file 
"SYSTEM.PASCAJ, on your system diskette. Re-bootlng lets the system 
discover a new boot-dlakette'a name, and also discover SYSTEM, PASCAL 
lew diskette location. 



^ 



^ 



The following tatile suramarizea the diBkflles needed by variouB 
command options: 

WHERE FILES MDST BE FOUND 

fany disk, any driven needed only ac start) 
(any disks, any drives; Tfranafer 

requires source flic to be present; 

can prompt for desclnatlen file) 

(any disk, any drive) 

(any disk, any drive; optional; default 
boot disk'*" SYSTEH.WRK.TEXT, any drive) 

(any disk, any drive) 

(any disk, any drive; default is boot 

disk's SYSTEM. WRK. TEXT, any drive) 
(boot disk, boot drive; re<^uired only 

If program USES Intrinsic Units) 
(any disk, any drive; optional; to fix 

errors found by Compiler) 
(boot disk, any drive; optional; providen 

error messages on entering Editor) 

(any disk, any drive) 
(any disk, any drive; required) 
(any disk, any drive; optional; pro- 
vides error mesaages in Assembler) 
(any diak, any drive; default ia hoot 

disk's SYSTEM. WRK. TEXT, any drive) 
(any disk, any drive; optional; to flK 
errors found by Asseinbler) 

(any disk, any drive; needed only to start] 
(any disk, any drive; default is boot 

disk's SYSTEM. WRK.C0I3E, any drive) 
(any disk, any drive; default is boot 

disk's SYSTEM. LIBRARY in any drive) 



COMMAND LEVEL 13 



COMMAND 


FILES NEEDED 


SYSTEM. FILER 

Fllea to he 


^ 


moved 


E(dit 


SYSTEtl. EDITOR 
Textflle to be 
Edited 


Ctompile 

■3 


SYSTEM. COMPILER 
TeKtfile to be 

Compiled 
SYSTEM- LIBRARY 


Id 


SYST5H.EPIT0R 
SYST™. SYNTAX 


11 

■^A(BHenbIe 


SYSTEM.ASSMBLER 
6^00. OPCODES 
6 5110. ERRORS 


TcKtIile to be 

Assembled 
SYSTEM. EDITOR 


Lflnk 


SYSTt^H. LINKER 
Host codeflle 



Library code file 



XCecute 



hfun 



Codefi U to be 

executed 
SYSTEM. LIBRARY 



SYSTEM* CHARS ET 

TeKt ai Cadefllti 
CD he Run 

SYSTEM, CUMP I LER 

SYSTEM. EDITOR 
SYSTEM. SYNTAX 
SYSTEM, LINKER 

SYSTEM. LIBRARY 
SYSTEM. LIBEtARY 

SYSTEM. PASCAL 
SYSTEM, CHARS ET 



LFCeer restdrL All Elles 

needed by laBl 
progcam □[ Dp Lion 



I(nlEUiJ£e 



Htalt 



ReciiEQ to 

CaiUP^iid 

Levul 



SYSTEM. PASCAL 
SYSTEM. MISCINFO 

SYSTEM. APPLE 
SYSTEM- PASCAL 
SY STEM. M:sC INFO 

SYSTEM, PASCAL 



{any diak, any drive; required only 
wlien loading, if no SETgiDcnL overlayH) 

(boot di^k, boDC drJvei ccqulred if the 
program uses long inCpgerg, does £llt 
I/n UBlne reals or SEEK, or USES 
Intrinsic UnJ ta) 

Cany disk, any drive; required if WCHAR 
or WSTRIWG called from TUftTLEGRAPHICS) 

(any disk, any drive; dcfaulr la boot 

disk's SYSTEM.WRK.CODE or .TEXT > 
(any dink, any drive; cequJred only if 

file being Run is a teiiCfile) 
(any disk, any drive; optloiial; tn fix 

errors found by Coinpiler) 
tboat disk, any drive; optional; provides 

error raesaagen on entering EdJcor) 
(any diak, any drive; requirod only if 

other routines need to be Linked In) 

(no Link needed to USE Intrinsic Units) 
(boot diak, any drive; required to hold 

needed routlnos !f Linker i:Eilled) 
(hoot disk, boot drive; required If 

prograiD usea long integers, dot's file 

I/O using reals or SEER, or USES 

Intrlnaid Undta) 
(boot disk, boot drive; required between 

Coinpl ling, Linking, ^nd executing, 
{flny disk, any drive; required only If 

program uses UCHAR or USTRINC from 

TURTLECHAPHICS) 

(sane file locations required by last 
prograiD or option) 



(any dtak, boot drive; chia disk 
becoioea the new boot dl^k) 



e: :3 



rr3 






If KJ 



(any disk, boot drive; first stagtf boot) I 

(any disk, boot drive; this diak Ui Ifl 

becomes the new boot disk) ^^1 *^ 

(boot diak, boot drive) 



The "boot drive" la volume fli: {slot 6, drive I). The "boot diak" Is 
the diskette that uaa in the boot drive the laat time the system waa 
booted fuaually APPLEtJi on one-drive syatema, and APPLEl; on larger 
systeiDS) . 



Here is where [he Bystiun files needed by the Coraiuand level are 
norms lly founds 



Dlakecte 
APPLE*): 



SYSTEM- PASCAl, 
SYSTEM MISC:nF0 

SYSTEM- COMPILER 

SYSTEM, EDITOR 
SYSTEM FILES 
SYSTEM-LIBRARY 
SYSTEM- CHARSET 
SYSTtW SYNTAX 



Diskette 
APPLE] : 

SYS TBI APPLE 
SYSTEM. PASCAL 
SYSTD1.M1SCINF0 



SYSTEM -EDITOR 
SYSTEM FILKR 
SYSTEM. LIBRARY 

SYSTEM .CHAR SET 
SYSTEM-SYNTAX 



Diskette 
APPLEZ- 

SYSTEM- COMPILER 

SYSTEM. LINKER 

SYSTEM. AS SMBLER 

6500 -OPCODES 
6300- ERRORS 



As you can see, there ia little difference between diskettes APPLE0 : 
and APPLEl; . Diskette APPI.E0: ia more convenient for editing and 
runntnft Paacal programs, espei^ially on nne-drlve ayatons, because it 
eontalna the file SYSTEM . COMPILER . However, APPLE0: cannot be uaed 
to cold-boot ttie system, as it fa lacking the file SYSTEM. APPLE , 
Diskette APPLEJ: contains all the filea you need lor editing text, and 
£or cold-booting the eystem. However, APPLE 1 : cannot be used to R(un 
or C(onplle yotr tent, as if is lacking the file SYSTEM. COMPILER . 
On cmiltiple-drlve syatema, APPLEI: Is often kept in the hoot drive and 
APFLE2: in another drive, thus loaklng all of the operating system 
available at all times. 

Most system files must he available In one of the disk drives 
constantly, from the inoment you aelect the Command option using that 
file until you quit that option or until it Cerminatea. This la true 
of the E(dlt, C(ompile, and Afssemble optiona. These pcograins 
are "overlaid", using segment procedures, so that different portions 
of the prograai are called In from diak as they are needed, to 
conserve laeinory. In such casea, If your system has only one disk 
drive you should use the Filer to T£ransfer all the necessary files to 
one diskette fusually the system diskette, APPLEflj or APPLE]:) before 
you select that option. 

Fllea containing non-overlayed programs are needed only at the moment 
the program Is loaded into the Apple's memory. Once they have begun 
execution, the source diskette may be removed from its drive. 

The F(ile CommEnd and Lfink Command options have been purposely written 
without .werlaying. The file SYSTEM. FILER is needed at Che ooment you 
aelect the F(lle option, but not subsequently. You should make sure a 
diskette containing SYST&!. FILER la in one of the disk drives when you 
select the F(lle option, but as soon aa the new FILER prompt line 
appears you may remove that diskette and put In any other. 
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Bysten Compiler. If & 
Jcally read Into the 

asks you Co specify a 
cDnpl lat Ian » if Che 
e option of calllna 
you i;orrecC it. After 
B ahVed Jn [he code 
oCher object codeflle- 
PASCAL COMPILER. 



Any time the Linker Is invoked, SYSTEM-LINKER muac be avalLahle. However 
when the LINKER prompt line appears, SYSTEM -LlhJKER ie no longer necessary' 
and the diskette conlalning SYSTEH -LINKER may be renuivfil froiii rhe aystem r t 
Lo make room fot oEher dlsketEes. 

More details about ualng the diskfl with various comcnands are given In 
the chapters on the Filer, Editor, Compiler, Assembler, and Linker, 

THE COMMAND LEVEL OPTIONS 

Many of the Conraand options are explained only briefly below. 

This manual's chapters on the Filer, the Editor, the Compiler, the 
Assembler, and the Linker discuss individual Gammand options in Diucb 
greater detal 1. 

F(ILE 

Typing F from Conmiand level places you in a level of The ayaten called 
the Filer. 'I\\s Filer contains coomiandB for saving, reading, moving 
and deleting the workfile and other disk Files. Other i^onmiflndB tell 
you what peripheral deviates and dlskectes are currently available to 
the systeiUk and what files are saved on each diskette- Still other 
commands let you check diskettes for daoiage or recording errors, and 
let you Set the system's current date and the default volume naoie. 
For more docuDienCation, see this manual's chapter THE FILER- 



E(DIT 

Typjnfi E while at the Command level Invokes the Editor program. If a 
worklile Js available, that file is automatically read Into the 
coQqjuter for editing- Othcrurise, the Editor aaks you to specJfy a 
tentfile or begin creating a new om^. While in Che Editor, you may 
create or alter text in Che workfiie or in any textfile- Various 
commanda allow you Co insert and delete inf ormat ion , find and replace 
specified character atringE, change the text Eormat ^ combine files, 
etc Un leaving the Editor, you may save your edited text In the 
updated workfile or In another specified file- See Chla manual's 
chapter THE EDITOR for detaila- 



C(OMPILE 

Typing C wliJle at the Conanand level invokes the 
text workf i Ie Js avai lable, chat file is automat 
computer for conqilllng. Otherwise, the Compiler 
source textflle and an object cudeflle- During 
Compiler detects s syntax error, It gives you Ch 
the Editor, which points out the error and lets 
a succeasful compilation, the resulting P-code i 
Wotkfile Einless you have previously specified an 
For more details, see tills jnanual's chapter THE 
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A(SSEMBLE 

Typing A from the Command level invokes the 6^02 Assembler program. 
If a text workfile is available, that file Is automatically resd Into 
the coiaputer for aesembllng' Otherwise, the Assembler asks you to 
specify a source textfile and an object codeflle. During assembly. If 
the Aascinbler detects a syntax error, it gives you the option of 
calling the Fdltor, which points out the error and lets you correct 
it- After a successful assembly, the resulting machine code is saved 
in the code workfile unless you have previously specified another 
object codeflle. For more in£ornatl*>n, see thla manual's chapter 
THE b5fl2 ASStHBLER. 



UINK 

Typing L from tie Command level fltfl.cta the system Linker program 
explicitly- Unlike the automatic linking initiated by the R(on 
comciand (see deicription bclowj, this option allows you to link 
previously coinpJled or assembled routines into your program, taking 
Chose routines from SYSTEM. LIBRARY or any other specified library 
£Jle. For more information, see this inanual's chapter THE LINKER. 



X(ECUTE 



^ After typing X Irom Che Coimaand level, the Bystein asks you to specify 



a previously compiled codeflle: 



EXECUTE WHAT FILE? 



You should [espand by typing the filename of Che compiled P-code 
program that you wish to be executed- 

It is not necessary to type the suffix -CODE ; that suffix ia 
automatically supplied by the system if you don't type it. If you wish 
to defeat tUls feature, in order to execute a program i^ioae filename 
does not have a -CODE suffix, type a period ( . ) after the last 
character of Che desired filename. 

When you have specified a codefile, that File is executed if it is 
available, except in the following cases: 

I) If all code necessary to execute the Pascal codefile has not yet 
been linked in, or if the file Is an unlinked assembly codefile, the 



b 
message 



HUST LCINK. FIRST 

Js displayed (see Ltink, above J . You are Immediately returned Co the 
Command level, vhere you may carry out the necessary linking process 
before enecutlng the linked file. 
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Z) If the apeclflad file coatflinB anything other than thi? exptcted 
compiled P-code, f£or exanipld, tPXL or linked assembly code) you will 
Bet: a camspge tjimilar to this; 

HTDISK MYFILE.CODE NOT CODE 

3) If the file SYSTEM. LIBRARY is not available in the expected 
dlakccte locflClons In the boot drive f#4:), or If that file ta nut 
CQBiplete, yon may be ahawn Che meBsage 

REQUIRED IHTHIMSTC(S> NOT AVAILABLE 

This Indicates Cb^t the prograrn ynu fite enecutirig uBea Units or 
routinea normally found In the file SYSTei. LIBRARY . Theae Include 
routines for long Integers, raiidoi:i numbers, transcendentnl funcClonG, 
game iiaddfe-s, gr^plilcs, and filp input and output using r«al nujuhers 
□r SEEK. 

fi) If tlie file SYSTEH.CHATtSET is not aunllable nn the hoot diskette, a 
program using WCHAfi or WSTHING from the Unit TUHTLrCRAPHItlS will be 
executed, but no charaeters will appear on the screen- 
It is convenient to Xfecute prOgrmiLS Which have already been cojopiled, 
but uhlch are not currently Id Che worSrflle- Otherwise, you uoirld 

have to tinter the Filer, Gfet the file (this identifies it as the next 
workfilp), QCutt the Filer, and Chen RCun the prograni. 

The most connnon operating system fanctlons can be aeLected directly 
fron tbe prompt lines. Functions UBed more rarely are supplied as 

utility programs, iriilch are available through the X£ocute dociniand. By 
Xfecuting these utllitioa, ypu can format new diskettes, place 
compiled or assEiobled routitios In the system librarv, configure your 
ayateni to run with an oKternal terminal, etc For a complete 
discuBHjon of theae abilities, see this manual'a chapter UTILITY 
PROGRAMS . 

R(UN 

Typing & from the Coonnand level Initiates the RC-n sequence, uljicb 
combinea the Command options C{orapIle, Lfint, and X(edUte, as needed. 
If a code workflLp ia ^jvailahle, Chat file ia autocia tEca 1 ly executed. 
Otherwise, the Compiler ia aucomaClcally called as described above- 
If the compilation reqciirca Unkage to other rouCines, the Linker is 
autornattcally invoked and looks for the r<mClnes only in Che file 
SYSTEM. LIBRARY on the hoot diskette- After succesEful coiipiiacion and 
linking Uf chose were nqcessary), Che program Is executed. See the 
descriptions of che options CfouLpile, L(lnk, and XCecute for more 
details. 

Note; between any two portions of the Rfun sequence, tlie system 
TPtums for an instant to the Command level. Thus the hoot diskette 
masi: ni-trmally remain in the boot drive tbrougliout the R{un sequence. 



^r^ 



The R(un option is one part of the normal program-developmenc process. 

Initially, the F:(dlt option Is used to create the first execuCablo 
portion of a new program. When this portion seems complete, it is 
saved in che workfiL-:. Then, Che R(iin option atteTnpCs Co compile the 
workfile and, if succeasful, to execute Che compiled program- To 
expand che program or to correct conipllacion errors, you go back to 
the E<dlt optloTi. Then the workfile Is UCpdated to contain thia dhw 
version, and you can BCun Che workfile again. And so on- 



D(EBUG 

The Dtubug prompt does noc correspond to a currently Implemented 
command. The Compiler Is called, but no debugging routines are 
available. Do not use this commBod. 



U(SER RESTART 

Typing V E rom the Command level tells the systoai to begin ejtecullng 
again che last Erograni or option which was executed. For example, tf 
you have just q^it the F-ditor Che U(Eer reaCart option will re-invoke 
the Editor; if you have just finished execucine a Pascal proRram, that 
program will be eKecuced again- 

KNITIAUZE 

Typing I from the Coiunand level has nearly the same effect as pressing 
Che Apple's RESET key. The system is re-started, and everything in 
memory is lost, but the P^code Interpreter is not re-loaded into the 
Language C^rd, so the diskette file SYSTEM, APPLE need not be present. 
Either diskette APFLEl : or diskette APPLE0: must bo in the boot drive, 
volume U: . 1 frit lalizing ia a little faster than the ^'warm boot" 
caused by RESET and the Pfrefia diskette name Is not forgoccen as it U 
when R£SET is pressed. 



H(ALT 

Typing H from the Command level does a ^'cold boot" of Che syscom, Just 
as if the system were being turned on for tbe first tine- The P-code 
interpreter is loaded Inco the Language Card and write-proCecCed 
there, sc the file KYSTEM-APPLE niusC be on the diskette in the boot 
drive, voluine ffCi . To accomplish this, one-dlsk^drlve systems and 
mulflple-dlsk-drlve ayscema must both have Che dlstfecte APPLEI: in the 
boot drive. After the H{alc command, you will have to repeaC the 
entire normal startup procedure- 
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COMMAND OPTION SUMMARY __^ 

ttsny of Chest options use Clie "workflle". The tejit portion of the 
WDEkflle Ig SYSTEM.WRK-TEXT, created on the boot diskette by Uie 
tditor's Ufpdate commaad. The code portJon of tkie uorkfUe Is 
SYSTEM. WRK-CCDE, created on the boot dlakeCCe by the R<un or C(oinplle 
cptlDns- In addition, the Filer's G(et coDditand can be used to 
deslgiuite any other text and/or code file as the workflle for the next 
option to LiSe> 

F(i le Invokes the Filer, which Is uaed to save, move, and 

retrieve inforinatJon scored on djakottes. 

E(dit Invokes the Editor, vhlch \r utied to CLreate and modify 

text- Reads the worlcflle or other specified textffle 
Into the Apple for editing. 

C(onplIe Invnkos the Pascal Compiler, which converts the text of a 

Paaciil program (found in the worlrfile or other specified 
tSKtflleJ Into executable F-cdde- 

ACssemble Invokes the Asseiobler, which converts the text of sn 

ussecihly-lan^uafte guhrouclne (found In tile workfile or 
other specJEled te^ctflte) into b'5^2 machine language- 

Lflnk Coinblnea cKtemal P-code and machJ ne-lanauaEe 

subroutines (found in SYSTEM. LLBKARY or other specified 
library codefile) into a Pascal host pcogrBm (found in 
the code wnrkfJle or other specified boat codefile). 

X(ecute Looda and runs the specified Pascal pragram codeflle- 

W(un EKecutGB the current workEliet automatically complllnj; 

and linking (from SYSTEH.LIBRAHY) first, if neceaaary- 

Dfebug Not inplemented; do not use tikis option* 

m&er reetart Accerapta to execute again the last program or option 
that waa executed' 

l(nItial3Ke Uoea a "worm boot" oE the SysteiL, alraflar to pressing the 

RESET key, but faster. 

Htalt Does a ^'cold boot" of the riystem, like turning the 

Apple's powor off and then on again- 
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CeqerDl Plle-Mfivlnfi Convoy nd 

f^encrvl DleirUp Coimuinds 

Workfil^ Canmanda 

Info miflC Ion CnranflndB 

Disk Upkeep Conmianda 
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INTRODUCTION 



The Filer porCJon of the Apple Paacal operaclng Byacein handles nust of ^9 
the casks of rranaferrlnfi JnforiiiflClon from ana place Co another. Savins ^^ 
InforaiflClon on disk, rnovina atid deleting disk files, BEndln§ Infonnatlcn 
to the computer or to the printer — these are some of the functions of B^ 
the Apple Pascal Filer* The Filer is also responsible for telling you 5 
where files have been placed on the diskettes, and ^Jhat devices and 
dlskecteb ate evallable for your ayatem's U9e> 



DISKFILES NEEDED 

The following dlakfJIe Is needed when you type F 
Filer, from the Coinmand level; 



CO select the 



SYSTEM. FILER 



<any diskette, any drive; required) 



When Che TtLEH prompt line appears, SYSTEH-FILER ig no longer 
necessary, and Ehe diskette containing SYSTEM-FlLEH nay be removed 
from the system to make room for other diakettea. The file 
SYSTEH-FILER is normally found on diskette APPLEfl : and also on 
dlBkettK APPLElj , so one of Chose should be In any available disk 
drive when you type F from the Command level. 

When you use the Filer's Tfranster command to transfer information 
from one diskette to another, the source diskette for the transfer 
must be available in any djek drive before you answer the question 
TRANSFER? When you have specified the destination for the transfer, 
you will be prompted to Insert the destination diskette if it is not 
already In a disk drive. This is not a problem with systems that 
have two or more diak drives, as both source and destination 
diskettes can be placed In available drives at the same time. 



i 
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The following dlskfile is needed when you type Q to Quit the Filer: K 
SYSTEM-PASCAL <on boot diskette, In hoot drive; required) 



This file must be on the boot diskette, in the boot drJve, and must 
occupy the same diskette locations that it occupied when the system was 
last booted. This means you should place APPLEB: or APPLEl: (whichever 
became your boot diskette when you last booted the system) back Into 
drive fl4: before you type Q to Quit the Filer. If you forget to do 
thia, the system will tell you to 

PUT IN APPLEl: I 

(If APPLEl: is your boot diskette). The boot drive will start again and 
again, until you press RESET or put the correct boot diskette in the hoot 
drive' I 
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TECHNICAL INFORMATION 

The Apple Pascal operating sysLen stores Inforinatlon on a diskette in 
33 concentric ^ones or bands, called "cracks", Tho disk drive's 
recording and readinfe head tan he moved In and out, to stop and hover 
o^er each of thEsc J5 differeni j^ones of the spinning diskette* 

I'he length of each track on the diskette is divided Into 16 soEmenta, 
called "sectors*. Once the disk drive's recording and reading head is 
positioned over a given track, that track's 16 sectors wlH pass under 
the head, one after the other, each time the diakette spins around. 

Each sector consists of an "address field" and a "data field". The 
address field tella the system citactly which sector of which track Is 
about Co be ceat from or written onto by the disk's read/record head. 
The address fields are written on a diskette Juat once, when the 
diskette is fotTiatted for first use. The data field is the portion of 
each sector usee for storing your data, code, or text information- Up 
to 25fi bytes of information can be stored In each sector's data field- 

The Apple Pascal system always stores information in two-sector units 
called "hlockfl", each containing 512 bytes Calso called "1/2 VC' bytes) 
of informHtion- Each of a diskette's 35 tracks can thus store eight 
blocks of information, for a total diskette atorage capacity of 280 
blocks (140 K bytes). While the Filer handles a]] of tliis for you 
automatically, the lowest-level Pascal routines for storing and 
retrieving diskette Informatiop are also available, through the system 
Intclnslcs LNlTtKITE and LTNITREAD (see the Apple Pascal Language 
Reference Manual for detallH), 

The 2efl blocks en a diskette are not all available for storing your 
pro^ranm nr other files- Blocks t^ and I are reserved for Che 
bootstrap pro^tdHi. In .itldltlon, every diskette must contain a 

ulrectory", which is the syatem's only way to recover the other 
inforoiation stored un that diskette- The directory occupies blocks 
2 through 5 on the disketti? and may store information for up to 77 
different files. 

A file Is stored on the diskette only In contiguoug blocks of 
contlguouQ tracks- Free blocks which are scattered here and there on 

the diskette may not be usable to store a Jar^e file, but you can use 
tlie K(runch coDmiand to combine scattered free blocka Into one 
contiguous area that con be used* 

If the W(rlte or U(pdate Editor option is chosen to save a file, the 
new version is saved; THEN the old version is delated. This uses more 
apace on the diskette, but also insures that at all times during thp 
Bauini^ process at least one version of your file is intact on the 
diskette. When the Editor's S(ave option is chosen, the original file 
is destroyed while the new fije Is being created. This comnijnd asks 
your permission before It ovt'twritea the old file with the new one. 
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VOLUMES 



INPUT AND OUTPUT DEVICES 

A "volume'^ is any input or output device, such aa the screen, Che 
keyboardi or a dlHk, A "block-structured" device fs nne that can liave 
a directory and fJles- In the Apple Pascal aytem, the only black- 
BtrucCuEed devices are the Disk II floppy disk drives, A nnn-block- 
structured device doea not have any Internal strucCurei it simply 
produces or consuoies a streanL of data* The screen and the keyboard, 
for example, are nQn-block-structured. 

A device may be referred to by its volume number or by Its volume 
name- The volume uaiae of a disk drive 1g die name of the diskette 
currently In that disk drive. The following table shous the reserved 
volune numbera and volume names that Apple Pascal uses to refer to 
Various input and output devices. 



Descriptiotk of 
Input/Output Device 

(not used) 
Screen and keyboard vlth ech 
Reads keyboard without «chol 

(not used) 
Boot disk drive (slot 6, dri 
2nd disk drive fslot 6, drl 
PrlDter 
Remote input 
Remote output 
5th disk drive 
6th disk drive 
Jrd disk drive 
^th disk drive 



Volume 




Tolune 


Number 




Kaow 


«0 








iti 






ecu SOLE: 


n 






SYSTERM; 


n 








H 




<dl 


skette name^ 


ffb 




<dl 


skette name> 


ifb 






PE4INTEB; 


07 






REHIN: 


tfti 






REMOUT: 


*9 




<dl 


skette name> 


tfie 




<dl 


skette narne^ 


#U 




<dl 


akette naine^ 


#12 




<(iiskette naiEie> 



(card In si 
(card 1 
si 
(slot 4, drl 
{slot 4, drl 
fslot 5, dri 
talot 5, drl 



o 

nfi it 

ve U 
ve 2) 
OE IJ 
n 

ot 2) 
ve U 
ve 2) 

VE 1) 

ve 2) 



VOLUME NAMES AND NUHBEHE 
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SPECIFYING A VOLUME 

Many Apple Pascal operating sygtem ci^mitiflnds require yon to specify at 

least one volume. A ctiiiiplete volume specification consists of the 

volume name or the volume number for Che desired device, followed 

by a colon C ! J- The colon Is very important: it tells Elie syBtem that 

the nam? or number preceding the colon Is a volume specification, and ^S\ 

not a dlakflle's filename- A stand-alone diskette vulume name or number |r*- 

(not folloved by a filename) tells the Filer that it Is to act Tel some I 



i 
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appropriate uay an Uie diskette AS A WHOLE, and not merely on a coctaln 
file On that diskette. If a volume number Is specified that Is not 
followed by a filename, the colon following the volume number is 
optional- The fallowing diagram defines Che syntax of volume 
specification: 



M> 



VOLUME 
NAMK 






V("iT,||Mp. 



<D 



VOLUME-S^EillFlCATLON SYNTAX 



The table of VOLUME HAMES AND tfUHBERS, given earlier, shows the volume 
numbers used to specify various Input and output devices, and the 
reserved volume names used to specify non— block'^acructuri^d devices such 
as a printer- 'The volume name for a block-structured volume (a disk 
drivej Is the nam? th^l you have atssigned to the diskette In that 
dri^e- Lf you apecify the volume number of a disk dri^e, the Filer 
autoiDaticaJly converts that specification to the volume name of the 
diskette found in that drive- A diskette's voluffie name rauat be seven 
or feuer characters long and may not contain an equals sign ( — ), 
dollar sign f 5 ), question mark (?) or comma ( , ). 



^Jote: Never issue operating system 
the dsme volume namt? are in the sys 
correct drives by their volume numb 
on the wron^ diskette (usually the 
drive). If the operation involves 
the system may ECuru the wn^n^i disk 
making the files originally on that 
problem inay oi:cur if you rt'place th 
diskette with die same ijolutne name 



commands when two diakettea with 
tcm, Hven if you Specify tlie 
ers, the aystem will often operate 
diskette in the hiHher-miinheri^d 
updating the diskette's di rectory , 
ette's directory onto your diskette 

diskette unavai lable. The same 
e diskette In a drive with another 



Moral: -lake SURE Che diskettes yuu use have DIFFEKENT voluir« namea- 
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SHORTHAND VOLUME NAMES 

An aaceriak £ * ) can be uastl to specify the vuliine name af che 
"Syatera" or "Hoct" diskccte, Che ditikette which was Id the boot drive 
fvolume ffi; ) when the Apple Pascal sygtera wafl last booted- The 
Filer's V[olimeH command reports the Asterisk default volume name aa 
the "ElOOT VOLUHB"- 

lE a filename is epecifJed with no precedlflg volume name or number, nr 

If d volume is apcclfled ulch only a colon ( : >, Che Apple Paecel 

system supplies Che volume name of the "Frefjx" vuliane, BooClng the 

system seta the Prefix to the name of the boot diskette' Thereafter, 

the Prefix default volume name can he chanaed at any time hy using the 

Filer's FtreflN command- Usually, you will aet this to the volume name 

of the diskette with which you are currently working, to save ciwch 
typing. However, the Prefix can also be act to other devices, aurh as 
the PklTJTER: . 



^ 



FILES 



DISKEHE FILE TYPES 

A "JiJLe" is a collection of iiif ormation which Is Btored or; the 
dlnketCe and which may be referred to by a filename- Each diskette 
has fl "directary" which contains the filenames and locationa of each 
file on the diskette- The File handler, or Filer, uses Che 
information contained in the diskette directory to manipulate filea- 

Tjie use of d file l9 determined by the file's "type", whlcli specifies 
the kind of information stored In che file- You and the computer can 
both tell the file's type when the file Is created by looklnfi aC a 
portion of the filename called the "suffix". Here are the filename 
suffixes normally recnanized by the coinputer. nnd the associated flic 
types as shown in the rightmost coliran of an Etxtended directory liatlne: 
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1 


^i 


i 


«' 


i 


»i 
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Suffix 

-TEXT 
.CODE 

-DATA 
■ GAD 



.INFlf 

.ciltJ^F 

.FUTO 



File Type 

Hucnan-readable text 

l-lac hi no -executable code 
Uata 



E(xtended directory 
llstiitE 
TEXTILE 

CauEFlLE 

DATAFILE 

BAE FILE 



Whon created by Efxamlne 
command, an IrammovabLe file 
coverins ^ physically 
dami^ged area of a diskette 

(not LiBBd) INFOFILE 

tnot used) GHAFFILE 

fnot uied) FOTUFILE 



i 



For instance, a file named MVFILE.TEXT Hatild be Created by the 
computer as a f J le containing human-readable text. For more 
Information conzerning the internal foERiat of the information 
contained in different types of files, see Appendix C 



^ 



Under some circumstances (after C{hanglng the file's name, for example) 

the file's actual type may not agree with it's filename suffix- the 

actual type of the file may be determined hy examining the rightmost 

coluuin of the £(xtended directory listing for the file. 

THE WORKFILE 

The workflle Js a scratch-pad diskette copy of the file currently being 
worked with. It is automatically taken as the default file by the 
Coramand-le Jtl CpCionS R(un, E(dit, C;(omplle, AC9:iemble, and Ulnk. The 
workfile can he a single diskette file, or It can consist of two or more 
diskette files with the same baelc filename but different suCflxes- 
Typlcally, the version with the -CODE suffix is the compiled nr 
asBcmhled Version of the file with the -TEXT suffix- Operatln§ aystem 
commands for dealing with the workfile automatically choose the correct 
version of the file. 

WVien a workfile Is Edited and Updated, the system stores the new text 
version on the hoot diskette, under the filename SYSTEM. WM. TEXT . When 
this new text workfile is compiled nr atisembled* the resulting code 
version of the workfile Is stored on the boot diskette under the 
filename SYiiXEH.WRK.CQDE - If you create tby Edit and Update! a new 
toxt version S'STEH.WHK.TEXT . the old code version SYSTEM. WHK. CODE Is 
autoDifltl colly erased - You may then create a new code veraion 
correBpondlng Co the new text version, by compiling or assembling the 
workfile. 

From the Filer, you can erase tho workfile (you raust do this before vou 
can Edit, Itun, Coiopile, nr Assemble any new file), save the workfile, 
or designate tbe next file to be the workfile. These Filer coinpanda 
automatically operate on oil available versions of the workfile. 

SPECIFYING A FILE 

Many Apjjle Pascal operating system commands require you to specify at 
leaat one file- A complete file specification consists of the volume 
name or number for the desired device, followed by a colon, followed — 
if you are specifying a dlak file — by the filename of Che particular 
disk file desired. This diagram defines file specification syntax: 



_. \S 



Vfll LlUff 

5i'H' i=inAnnii 



7 
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Filenames 

Qnce a disTc device is ^pe^ffi^dt by Its volume nurabcr or by the name 
o£ tlie UigketCe In that drive, any file an that diskette may be 
specified by Itn Ellenaiae. A legal di£.kttte Hlen^iae can cdnalat of 
up to 15 characters- In order for the file to be Hun, Che last five 
characters nnist be -TEXT or -CODE . Without a -TEXT ni a ,GODE suffix, 
the file nay bo c>re[:Lited but it may not be put In cho worftflle. Lower- 
case lectera typed into a filename are tranalated to upper-case, and 
apacea and non-prlntl tfg cbaracters are remived from Che fllenanie- 
All characcers are legal in fllenameB- However, from the keyboard you 
should not type filenames EliaC include the following characteT^: 
dollar algn fS), left Square bracket ((), equals sign (=), question mark 
t?K JtETJRN, and Che CTHL characters G, F, H, S, V, and @. 



■■^^. 



WAHFJir^C^: Tlie Flier ulLl not ba able to anQe^^i ElleDames containing Che 
[:haracCers dollar sign (5). equals aifin ( = ), question Tiiark 
(7}i ur coDDia (,)- 

File Size Specification 

It is aooetlmeu possible to sped Ey the alse of a disk file Imiedlfltely 
after the filename, by enclosing In square brackets [like thlaj the 
number of diskette blocks the fUc is to occupy. There are also Cwo 
shorthand file alze speci f 1 caClons : [flj says the file la to occupy all 
o£ Che largest unuged area, while I*] says the file Is Co occupy all of 
the aocond-largest area or half of the largest area, whichever la 
larger. If no file sljt« Bper:i f IcatJ on la given, Che iisual default Js 
[(Jj • The file Blae specification is primarily useful in Che Filer 
comaands Ttransfer and M(ake, However, It can alao be used in the 
Aasembler when apeclfying the output codeflle, where [*] ia the Eile- 
Slze defaulC- 

Shorthand Filename 

The Tlranafor coiaraand will accept Che dollar sign ( S ) as Its SECOHP 
apecified filonajEe* This means Chat Che transferred copy of the file 
is to have the Bame filename as the original file. 

Wildcards 

The wildcard cliaracters, equals sign ( ■ ) and question mark ( 7 ), 
are used to specify a subset of the filenaioes on a diskette, by 
iniiicatin^ the portion of a filename which may be ignored or which 
remains uuchariged- The Flier performs the requested action on all 
files whose filenames meet the subset sped fl cat Jon< The form of a 
wildcard fllenaoke specification la as followa: 




*a trliiEl>=<a tri nB2> 



<a t rl ngl>3 <3 tringZ^ 



where ■^Crlngl>and ^HCriTig2> are sometimes called Che "subaet- 
specifying atrings". The subset-specifying strings Indicate the 
portion of a filename which niay NOT be ignored or which is to be 
changed. For example, the filename aubaet specif 1 cat ion 

HYDISKiDDC-TEXT 

tells the Filer to perform the requested action an all of MYDISKi's 
filea whose filenames begin with the string DDC and end with the 
string TE>lT . l£ a question mark is used inatead of an equals sign 

HYDISK:DOC?TEXT 

the effect is identical except that the Filer requesCs verification 
before affecting each file In Che speciflad subset' Instead of a *'Y" or 
an "W" response, you may press Che ESC key. Thle will return you to 

the outer level of the Filer. 

Only one wildcard may be used In a filename specification: 

MYT)ISKriW?TE?T or >fYDISK:-TE= 

are NOT legal specifications, because one of the subaet-speclfylna 

seringa contains the forbidden filename character ? or - - An 

attempt to use the first apeclficaCion shown above will cause the 
message 

TE?T SCAN STRING - ILLEGAL FORMj^lT 

The Filer eoimiands Tfransfer and C(hange both require two file 
specifications. If the first specification contains a wildcard (and 
the second specification la for a disk volume), the second 
specification must also concaln a wildcard. If you forget, you will 
be given the message 

BAD FOHM (WILD <TO> NON-WILD) CARD 

The only legal exception Co this rule occurs when TtranBfec ia given tha 

S as the second filename specification. 

Either or botli "i the suhaet-specl f ying strings may be empty- For 
examplei a filename subset specification such aa =TEXT or DOC-= or 
even Just = is valid. This last case, where both Hubset-speclfying 
strings are empty, la interpreted by the Filer to specify every 
filename, so typing ■■ or ? alone cauaes the Flier to perform the 
appropriate actlsn on every file in Che specified diskette's 
directory. This feature can sometimes be used to act on a file whose 
filename is not 'Vecogniied" by Filer commands tbecause of illegal 
characters in the filename, or a slightly damaged directory, say]. 

The aubset-apecifying strings may not "overlap". For example, Che 
filename subset specified by GOQN^NS would not include Che filename 
GOONti, whereas GOON-S would be a valid {although pointless) 
speclflcatian for Che filename GOONS . 



30 APPLE RASCAL OPERATING SYSTEM 



FILER 31 



EXAMPLE: 

Suppose you are given this directory for Che dlskeCtB volume named MYDISK' 

NAUCHTVfltTS 6 22-JUH-7fi 

[iOLD.TEXT A 29-JAN^57 

USELESS, CODE 10 12-MAY-7a 

MOLD. CODE A 29-JAIi-57 

NEVERMORE. TEXT 12 5-APR-7A 

GOONS 5 lffl-SEP-52 

After typing R foe R(einave, you will aep this lopssa^^: 

REMOVE WHAT FILE ? or REMOVE 1 

Keapona? 1: t1YDISt::N- 

Typing the abovE responfle generaCse the meesags; 

MVJJ:SK:HAUGHTYBITS — > REMOVED 

MYDISKiNEVEHHGRE.THXT ^> REMOVED 

UPDATE DIRECTORY 1 

Ac thfa polDt you can type Y to remove all the fHea marked REMOVED, 
or you can type N , Jn which case the files will not be removed. The 
Filer iiluayti requests veri£Ii:fltlon before campleting any vlldcard reniDvee. 

RespDiiae 2: MYQISKiN? 

Typing thlif redpDUfie generates the meBsager 

REMOVE NAUGHTYBITS 1 
After you type a rESponae (Y or H) , the Filer asks: 

REMOVE NEVERMORE , TEXT 7 

Again you tna^i type a response (Y or H) , dnd If you have given any Y 
responses, the Fllec aakg: 

UPDATE DiaECTORY 7 

As with the pEevloUfi pattern, this gives you one last chanut? Co change 
your nlnd before the files ate finally temoved. 

EXAMPLE: 

Again, suppose you have a diskette MVDISK: with the sainG directory as 
in the preylauQ example- After typing L for L(dJr Jwhlch iDeans List 
the diskette's Directory), you will see tills message: 

DIR LISTINU OF WHAT VOL ? or DIR LISTING OF ? 

Response: MYDlSK:=TE:cr 
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Typing this reaponse cJiuries the Filer to list 

MOLD -TEXT A 29-JAN-57 

NEVERMORE. TEXT 12 5-APR-7^ 

USING THE FILER 



Type F at the CoimuaQd level to enCec the Filer and the following 

pronpt Is displayed: 

Filet: G(ET, S(AVE, W(HAT. N(EW, L(D1R, R{EM. C(HNG. T(RAHS, D(ATE, QCUIT 
or 

FILER: G, S» N, L, R, C, T, D, Q 

Typing 1 in response Co this prompt displays more Filer corauiflndH; 

FILER: B(AD-BLKS, E(XT-niR. KtRNCH, MlAKE, P(REFIX, V(OLS, XCAHlNE, Z(ERO 

or 

FILER: W, &, E, K. rt, P, V, X, Z 

The letters and numbers enclosed In brackets which frequently appear at 
the end of prompt lines indicate the version number of Che portion of 
the program with i-rtiich you are working. 

An individual Filer command Is Invoked by typing the first letter of 
the command option as It appears in the prompt line. For example, 
typing S would Invoke the Save command- 
in the Filer, answerlnft a Yes/No question with anv character other 
than Y constitutes a "No" answer. With iranst questions, pressing the 
RETURTJ key as your only response will terminate that toramDnd and 
return you to the cutter level of the Filer. 

For each command requiring a file specification, refer to the file 
specification diagram earlier In thJa chapter- In many cases, Che 
entire file speclMcatlon Is not tieceasary, and In some cases, certain 
parts of the file specification are not valid. Terminate the 
specification by pressing the RETURN key- See the required command In 
the following section fnl Diore details. 



Whenever a Filer command requests 
specify as many files as desired^ 
specifications with C(jiniiiae> dnd t 
pressin^i the EUlTURI^ key. Command 
keep reading fllensj^es from Che f 
there are none ieft. Cooiraands op 
Lflst-dicectory, i^Change, and T(r 
specifications Jn pairs and opera 
none remains. If one filename re 
second member of the pair. If an 
the list, the remainder of the 11 



a file specification, you may 

by separating the file 
eriTilnating this "fi le list" by 
s operating on single filenanies ui LI 
ile list and Operating on them until 
orating on twn filenames (such as 
ansfer ) will take Elle 
te on esch pair until only one or 
mains, the Filer will prompt for the 

error is detected at any point In 
St will be discarded- 
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GEHERAL FILE-WOVING COMMAND 


3b 


T(ranafer 


U2 


copying a diskette 


hk 


GENERAL DISKFILE COMMANDS 


4A 


M(ake 


45 


C (haage 


t^% 


Bjenove 


49 


K(runch 


50 


ECero 


5! 


WORKFILE COMMANDS 


51 


G£et 


53 


S(flve 


55 


HUu 


55 


U(hsc 


55 


INFORMATION COMMANDS 


55 


V(ciliimes 


5b 


L(lBt dlrertacy 


59 


ECKtended directorj' list 


fil 


DISK UPKEEP COMMANDS 


61 


BUd hlojzka 


62 


X{ amine 


65 


MISCELLANEOUS COMMANDS 


65 


P(re£LK 


65 


□ (dte 


6& 


q(uit 



GENERAL FILE-MOVING COMMAND 



Kransfer 

Copies the specified file to the gtven deHClnatlnn, 

This cGDimand cequires chat you type two Elle specifications, ono f fl c 
the source file and one for the desclnacion file, aepatated with 

eicher a cominfl nt a RETURN . Wlldcarda are permitted, and slEe 
apeclf Icfltion Infonriation la recognlied fot Clie desclnation flle- 

The Bource device or diskette musC he available (the source dlakette 
must be in one of the disk dtivEs) uSen the Filet readH yout aoiitce- 
file specif icfltion, hut a deatination diskette may be insetted lateE, 
In response to a pronpting neBsage. 
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Note! Do not atlenipt to transfer Infonaaclon between different diskettes 
havinc the same volume name- Instead, Cthange the narne of one of the 
diskettes, at least for the duration of the transCer- 



EXAJIPLE: 

Suppose you wlsb to transfer the file FARKLE.TEXT fraci the dl^^fette 
named MYDISK: to the diskette named BACKU?: . 



Prompt.: 



TRANSFER WHAT FILE 7 or TKANSFER ? 



Respnnae: MYDIEK:FARKLE-TEXT 

When you jiress the RETUliN key, the system checks to be dure that Che 
specified source diskette is In one of the disk drlveSi If MYDISK; is 
not in any drive, you will see che nessagB 

Mm 15 K : F ARKLE . TEXT 

NO BUCH VOL ON-LINE <SOURCE> 

If the source dJskette is found In a drive, the Hysteni then checks to 
be sure the specified file is on that diskette. If the diskette 

hYDISK: la in a drive, hut It has no file named FARKLE.TE>:T , you will 
see Che measarie 

Mn3 1 SK; FARKLE . TEXT 
FILE NOT FUUND <SOURCE> 

In either case, you will he returned to the outer Filer level- Just 
Insert the correct source diskette In any drive and type T again. 

However, let's assume che systEEi succeeds In finding the aource 
diskette and file. The dialogue continues^ asking you to specify the 
destination for the transfer: 

Froopt; TO WHERE ? 

Response; BACKUP: NAME, TEXT 

(NoteJ The file's source and destination specifications could also 
have been given both In the first response, separated by a comma.) 

When you press the RETURN key, the system checks to he sure the 
destination diskette is in a dlak drive- If it Is, the transfer 
begins- If it Is not, there Is a pauae, and then you will be 
promjjted 
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PUT la BACKUP: 

TYPE <space;> tq continue 

Put the qgrreot deatlnfltlon diakecte in any Hvallable drive and press 
the apatebar. On tuo^drlvd gystcrafi, you will nDrinally put the Hourco 
diskette in one drive and the dcatlnaClun disketLe Iq the other 
drive- On one-drive syatemE, you will have to remove the aotirce 
diskette from Che diak drive, and then put the destination diskette in 
the drive. 

DiPUKTAfJT: On a single-drive system, DO NOT remove yom source 
diakettG until you are prompted to inaerC the deHtinatlon diskette. 
You will be aiven the following message vtien It ia Cine to exchange 

dldkettes in tlie drive: 

PtDnqit: PUT IN BACKUP: 

TYPE <SPACE> TO COHTIHUE 

Wljen you see that message, you should cemove Che source diskette from 
Che drive, Inaert the correct deatinatlon diskette, and pteas the 
spacebar* It the specified tlie is large, you may liavo to switch 
the source and destination diskettes several tlmeSi until the transfer 

is completed. Just follow Che prompting mepHfli;es. 

Svltohing the diskettes la not usirally necessary on systema with two 
or more disk drives, as the aource and destination diskettes can be In 
dlilerent drives at the same time. Howcvecj the one-drive procedure 
will also work on mui Ciple-drive ayaCems. 

When the transfer is coaqjlete, the Filer ulll give you the measaae 

MYUISKiFAiiKLP.TEXT 
— =■ bACKUP; SAME. TEXT 

The flier has made a copy of FAftKLE . TEJH' as found on Che diskette 
named llYDlSK: , and hss stored that copy on the diskette MCKUP: under 
the filename NAME. TEXT . 

Note: Once the Filer has been Summoned, It resides imtirely In the 
Caraputer's memory. Un a one-drive ayatnin, you can sutmaDn the Filer 
and Chen remove the system diskette from the drive in order to Insert 
the source diskette for the Trnnsiicr. On a two-dnvt systecn, you can 
suwron the filer, and Ltten remove al ] aystera diskettes rroin the drives 
In order to use both dri/es £or source and destination diakettes 
during a transfer- This will save you much unneceasary switching o£ 
diakettes when copying a large file- Just remember to repJaco the 
system diskette In the boot drive (volume lff*t) before UulttlnB the 
riier. 



It is often convenient to transfer r llle to another diskette without 
chan^^lng its filename. To make this uasler, the Filer leta you uae 
the doilar-aign character { S ) as a shorthand for "aamc name", to 
replace the Ellenaine in tht' destination file specification- In the 
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above example, if you had wished to save the file FARKLE-TEXT on 
diskette BACKUP; under the same filename FARKLE.TEXT^ you could have 

typed: 



MYI)1SK:FARKLE. TEXT, BACKUP: S 



3 ® 
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WARNING: Avoid typing Che aeco^id file specification with the filename 
con^letely omittedl For example^ a response to the Transfer prompt of 
the formi 

mriEKj FARKLE-TEXT , BACKUP : 
generates the raeasagei 

DESTROY BACKUP: 7 
Typing Che response V causes the directocy of BACKUP to be wiped out! 



A file can be Cranfiferred from a diskette to a different plaee on the 
same diskette hy giving the same volume name for both source and 
destination file spec] fi cations . This is frequently useful when the 
you wish Co relocate a file an the dlakette. Specifying the number of 
blocks desired will cause the Filer to copy the file In Che first 
(loueat block nurabera) unused diskette area of at least Chat size. If 
no siae specification Is given, the file la always written In the 
largest unused area. 

If you specify the same filename for both source and destination on a 
same-dlskecte transfer, then the Filer rewrites the file to the slze- 
specltled area tthe largest unused areaj if not specified), and 
removes the original file- 



EXAMPLE: 

Prompt: THAMSFEK WHAT FILE 7 or TRANSFER 7 

keaponaer MYDlSK:qUI^^ES,TEKT,^m}^SK:S[20J 

Typing this reaponse would cause the Filer to rewrite QUIZZES. TEXT 
on MYUIS*:; In the first area of at least 2^ blacks Uooklng from 
block 0) and Chen to remove the previous version of QUIZZES. TEXT . 

Note: do not use this feature for re-naming a file. The C(hange 
coDBoand is designed for that purpose, and is less risky. 

If you give the same volume NUMHEH for both source and destination 
file Bpaclflcatlan, the system assumes you are going to change 
diskettes in that drive. You will see the luessage 

INSERT DESTINATION DISK 
TYPE <BPACE> TO CONTINUE 
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The aant! aesuioptlon la made any [Irae you give a volune number, In the 
destJnaciod file Hpecjf Icfltlon, ChflC apeelflea the same dclv& occupied 
hy Che source df&kette. 



eHes may be transferred to such volumea as CONSOLE: {foe a quick 
flcccEn iiHCiiig of a fdie) and PRINTEH: (to print a file), aa well as 
to a dJak, by BpecJfyJng the appropriate volume name or number (see 
VOLUtlES, earlier in this chapter) In [he descinatiun file 
apeclficaclon- A £ilen;ii:ie on a device other than a disk la ignored* 
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IL la genocally a good Idea Co nalce certain that a non-disk device la 
on-line (actively connected to the system and turned on) when you 
attempt a Transfer to chat device* If It Isn't, the gysCem jnay 
"hany", and you will have to press the RESET key to recover. 



EXAMPLE! 

Pruinpt: rHANSFER UUAT FILE ? or TRANSFER ? 

Response; fARKLE.TEXT 

Prompt; TO UHKRE 7 

RtiflpOQBcJ PRINTER: 

Typing the above reaponaes will cause the file FAHKLE-TEXT , as found 
on the Prefix diskette volume, to he printed {assuming a printer Is 
properly ctjnnscted to your system)' 

You may also transfer from input devices other than diaks, such 311 the 
keyboard- Filenames accoiiqianying a ntm-dlak iroliinie name or number are 
ignored- 

EXAMPLE: 

frompc: TKANSFEk UKAT FILE ? or TRANSFtR 7 

Hesponfie: (>JNSOLE: 

Prompt: T(J WJCERE ? 

fleaponae; PRINT KR: 

Aftcc these responses, you can use your keyboard as a typeurlter- 
Nothing will appear on the printer until you type the "End-Of "fl le" 
character, CTRL-G [Note some printers require you to pcesa the 
RETURN key before pressing CTRL-C), Then all your typing will be 
sent to the pcinter. 




The wildcard capability Is allowed in the Ttranafer commandp When 
using wildcards, the suhaet-apecifying atrlags in tile source filenames 
will be replaced by the analogous strings (called "replacement 
atrlngs") in the destination fJlenames- Any of Che aubset-epecifying 
or replacement strings may be empty. The portion of each source 
filename accounted for hy the =' or 7 wildcard character is 
reproduced unchanged in Che corresponding destination filename- 
RemeiDljer that the Filer considers Che une-character . w1 Id-csrd-alone 
file EpecJf Icatli;]n ( » or ? ) to specify every file on the volume. 



EXAMPLE! 

Suppose the Prefix diskette volume MVDISK! contains these filesl 

PAUCITY 
PARITY 

PENALTY 

Further, suppose the destination diskette is named QUUNAMZ: 

Prompt: TEAHSFER WHAT FILE 7 or TRANSFER ? 

ReHponae: P-TY,0DDNAM2: V=S 

Typing this response would cause the F^ler to reply; 

MYUlHK: PAUCITY 

— > UDDNA.4Z!VAUCIS 
MYUISK: PARITY 

—> CDDNAJ1Z:VARIS 
MYDlSKiPEJJALTY 
"-> CDDWAHZ:VENALS 

EXAMPLE: 

Suppose the Prefix diskette Volume MTDISK: contains these files; 

CHAPl.TECT 

CHAP2.TEXT 

CHAPTFR-3.TF-XT 

CHAP4.TEXT 

Further, suppose the destination disfceCCe is named BACKUP: 

Prompt: THANSJ'ER WHAT FILE 7 or TRANSFER ? 

Response! C^XT 

Prompt: TO WHERE ? 

Response: BACKUP :OLDC-XT 
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Typing These responsEB would cause the filer co reply: 

MYD I SK ! CHAP U TEXT 
--> BACKUPiOLDCHAPL-TEXT 

WYDISK: CHAP? -TEXT 

— > BACKll?:OLDCHAP?.TEXT 
M YD I S K r CHAPT EFi- 3 . TE XT 

— > NOT PROCESSED 
M¥D ISK- CHAP i. TEXT 

--> BACKUP:l3LDCHAPA.TEXT 

On Che third attempted transfer, the dcBtinatlon filename would have 
been 0LDCI1APTER-3,TEXT, which exceeds the IS-chflEacter limit for 
ftlenaraea. Therefore, that file uaa "NOT ppOCl-SSED" . If all of the 
destlnatlaa filenames exceed 15 characters, each source file Is niarked 
"NOT PROCESSED" and this additional Tneasage Is given: 

BAD DEST FOR FILES FOUND 

□fling the single character = as the source fllenatne spECif Ication 
vlll cause the Filer Co attempt to traasfer every file on the source 
diskette, adding thefle files to the Information that was already 
stored an the destination diskette- Vou can use this feature to 
transfer all the Informaclon on one diiikeEEie to another diskette, 
wlthOUT destroying any Infermatlcn already on the destination 
diskette- (If you i^lah to make an exact copy of the source diskette, 
completely erasing any Information that was formerly stored on the 
destination diskette, please refer to the material later In Chla 
section on volume- to-uolume transfers: COPYING A DISKETTE O 

Using the single character = as the destination filenainc 
HpecHlcation will have the effect of replacing any subset-GpecifylaB 
strings In the source specification with nothing. 

A brief reminder: in any wildcard specification, the single character 
1 may be used In plac? of = . The only difference Is that a ? In 
either specification (or both) causes the Filer to ask you for 
Verification before each file Is transferred. This takes somewhat 
longer, but you are more ccrcain of translerrlng only the files you 
intended to transfer. 

A source or a destination file specification must contain only one 
wildcard character- A specification such as 

MTDISK:?UGH? 

is NOT a legal specification- An atteiDpt to use such a specification 
as either the source or the destination of a transfer Mill cause the 
Jargon nessage 

SCAN STRING * aLFCAL FOWlAT 
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If the source file specification contains a wildcard character, and 
the destination device is a disk, then the destination file 
specification muat also contain a wildcard character- If vou Eail to 
have a wildcard character In both source and destination specification 
fit need not be the same wildcard), you are Riven the message 

BAD FORM (WILD <T0> NON-WILD) CARD 

and your transfer is terminated. The only oKceplIon to this occurs 
when you use the dollar sign { S 1 shorthand for the destination file 
specification- 



EXAMPLE: 

Suppose the diskette MTOrSK! contains the follouinE files: 

CHAPTER UTFKT 

CHAPTEHlfifl-TEXT 

INTBO,TEXT 

Further, suppose you wish to transfer the files CHAPTEHl -TEXT and 
INTRD.TEXT to the diskette BACKUP: , retaining the flame fUe names on 
the backup dlskecte. 

Prompt! TRANSFER ? 

Responae: f^DlS^:: ?. TEXT, BACKUP: S 

Typing this response would cause the screen to dear, and then the 
fallowing message would appear: 

TRANSFER CHAPTERl-TEXT ? 

Since you wish to transfer CHAPTER 1-TEXT , type a Y for "Yes", A 
copy of the file CHAPTER] -TEXT would Chen he transferred from MYDISK: 
to BACKUP: , and the Filer would proceed to ask if you wish to 
tranafer the nem file whoae name ends in -TEXT . The complete 
dialogue might appear as follows: 

TRANSFER CHAPTER L -TF-XT ? V 
MVD ISK I OIAPTER I - TEXT 
— > BACK[fr:CHAPTEKL.TEXT 

TftMSFEH CHAPTEHUB.TEXT 1 N 
THANSFER INTRO. TEXT f V 
MYD1SK:[NTR0.TEXT 
—5 BACKUP :INTRO.TEXT 



Instead of a "V" or "N" response, you may presfl the ESC key. This 
will return you to the outer level of the Filer. 
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Copying a Diskette 

You can copy an eatlre diBkerCe. The file flpecf f Icfltions for ChE 
source and foe the destination should each consist of a disk voluine 
nfliue or numlier oqly. This method of transferrlna the contents of a 
BOurcE dlakDtte volume onto a destination diskette volume erases any 
prevlouH contents that were on the destination diskette aa that Jt 
hecamea an eiact, literal copy of the source diskette- After copying, 
the destlnatlan diskette has the same volume name aa the aource 
diskette. 



EXAMPLE: 

Suppose you desire an extra copy of the diskette MYDlSK: and you are 
Willing CO aacrlflce diskette EXTRA; 

Prompt: TRANSFER WHAT FILE ? or TRANSFER ? 

ReBponHe: MYDtSK: , EXTRA: 

Prompt: TRANSFEJt 2^0 BLOCKS 7 (Y/N) 

Reaponse: Y 

tintPl To copy an entire diskette (each dlakette used by the Apple 
Pascal system contains 2&0 blocks), you will always type the response 
Y • Eacli diskette's directory telLs your computer liou many blocks are 
on that diskette- It your system ever gives a oiessflH^ such as 

TRANSFEK 1130 BLOCKS? (t/H) 

(or any nmnber other than 230 blocks), the diskette's directory is 
prohaLily damaged. 



Prompt : 



DKSTKOY EXTRA; ? 



WAkUlWG; If you type Y , the djcectory (and therefore, your access to 
the contents) of EXTRA: will be destroyed! The diskette named F-XTHA: 
uiU then become an exact copy of MYDlSK: , even having the same 
volume narae. Often this Is desirable for backup ptirpoaea, since it is 
relatively easy to copy a diskette this way, and the volume name can 
be chaniied (see the Cthfinge coi^mand) If desired. An N response Jill 
return you to the outer level of the Filer, 

Althoujih IC la certainly possible to transfer one diskette volume to 
another using a ei ngle-disk-drlve system, tt le a fairly tedious 
process, since a great deal of diskette eKchanglng la necessary for 
the complete transfer to take place* 
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IMPORTANTt On a aingle-drlve system, DO WOT remove your source 
diskette until you are prompted to insert Che deHtlnatlon diskette- 
You will ho given the following loessage vhen it Ja cine to exchange 

diskottes in the drive: 



Prompt : 



PUT IN EXTRA! 

TYPE cSFAGE> TO CONTlNLTE 



You should now r°jiiove the source diskette from Che drive, insert the 
correct destination diskette, and press the spacebar. The Filer will 
soon cell you 

ProDipt: PUT IM MYUISK: 

TYPE (HPACE> TO CONTTNDE 

and ao on, back and forth, until you have exchanged the source and 
deHtlnatlon diskettes In the drive about 2(1 times. Finally, the 
Filer will give ;^ou the welcome message: 

MYUIS.-;: —> EXTRA: 

to tell you the transfer is completed. 

Note- Once the Filer has been summoned, Ic resides entirely in the 
computer's memory. 

One-drive note: Jn a one-drive system, you can surrannn the FJler and 
then reciove the system diskette from the drive in order to insert the 
source diskette for the transfer- Just remember to coplace the system 
diskette in the boot drive (voluDie ^4: ) before Quitting the Flier- 

Two-drive iioce: Qn s two-drive aystera, you can summon the Filer, and 
then remove all system diskettes from the drives In order to use both 
drives for source and destination diakettoa during a transfer- This 
will save you muih unnecessary switching of diskettes when copying an 
entire diskette- A^aln, remember to replace the systeui diskette in 
the boot drive {volume H:) before Qulttlna the Filer. 



Another nne-drlve note: One— drive uaers cannot make a volune-to-voluine 
copy onto a descEnation diskette thsL has the same volume name as the 
source disketce- Instead, before trying to make the copy, use the 
Flier's C(hange comcLand to change the volume name of either diskette, 
or use the Ziero command to rename the desLlnation diskette while 
erasing Its directory. 

Another miitl-drive note: In mulciple-dElve systemo, the source and 
destination diskettes are usually placed In different drives. If the 
two diskettes have the saniK volume name, you can refer Co each 
diskette by Ice drive volume number, instead of by name- By their 

different drive numbers sh.Tll the Filet know them- Note that this full- 
disk copy is an exception to the rule which forbids two diskettes with 
the saiae name in the system- 
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GENERAL DISKFILE COMMANDS 



M(ake 

CreaC&& a dlskeCCe directory entry with the specified fllcnaiDe-. 

This coDBiand requires you ta Cype a file Bpecificatlon. W:ildcflrd 
charactera are not allowed- The file bI^ep specification optJon is 
eHtremely helpful, since, if It 1e omitted, the Filer creates the 
specified file hy consuming the largest unused area of the disk. The 
file Blae is deCerodned by following the filename wltli the dealced 
number of blocks, enclosed In square brackets [ and } ■ Some special 
cases are; 

IflJ - Equivalent to omltcing the size specification. The file 
la created using all of the largest unused area. 

(*| - The file Is created using fill of Che second larp;eat area, 
or hfllf of Che largest area, whichever is lacger- 

Files with filenames ending in -TEXT muat occupy at leaet four blocks, 
and must occupy an even number of blocks (see this nianusl's appendix 
FILE FORMATS for details). An attempt to M(ake a .TEXT file with fewer 
than four blacks results in the message NO KDDM ON VOL. If you Hfake a 
-TiiKT file specifying an odd number of blocks, the file will actudllv be 
made vlth one fewer block. 

EXAMPLE: 

frouqit: HAKE WHAT FILE? 

Responae! HYLISK: FARKLE,TEXT [3d] 

This response creates the dunimy file FARKLE.TEXT on the voliune HWJISK: 
in the first unused 2S-block area encounteced- 

The H(ake comniand is commonly used to ri^serve an erea on the disk for 
some future use* The created file's nacne may serve as a reminder that 
you need to write a section by that name, and save you some apace on the 
diskette to do so. It also prevents use of that space by other files. 

When you make a file, yuu simply create a diskette directory enCry, 
without In any way changing the actual information stared on the 
pocLlon of the diskette to which that directory entcy refers. If yu" 
forget that the file is a "dummy" file, you can G{et the file (if it 
ends in .TEXT) and attempt to read into the Editor whflCever infornratlon 
may have been stored on the diskette In that location. Usually, this 
will just be nonsense, or part of some file you never wanted to see 
again, but occasionally it can be usoful- 

Suppoae you haye just H{emoved a 19 block file, which atarteJ at block 
t3A. An E(xtended directory list of the diskette may shou the "hole" 




where that file used to be, as a 19 block <unused> area starting at 
block 134. If you can now M(ake a file [of any name) that exactly 
occupies the blocks the R(emoved file occupied, the new file will 
contain exectly the saTae information the Removed file contained. Thus, 
if you know enough Information about the locaclon of a file before it 
was Removed, and if nothing! has been written over that area of the 
diskette since the removal, you can soraetlmes use Che Mfake comnand to 
recover a Removed file- 



C(hange 

Changea a diskette file's filename, or changes a diskette's volume name. 

This conmand requires two file specifications- The first of these 
specifies Che file or the volume whose name la to be changed; Che 
second specltlcation shows the new filename or Che new volume name. 
The first Hpeclficatlun is separaCed from the second specif icacion 
either by a conmi-i < , ) or by pressing the RETURN key. if the first 
file specification contains a filename, any volume name or number in 
Che second file specification Is ignored, since obviously the "old 
file" and the "new file" are on tlie same volume! Siie spec! fl cation 
Information iR Ignored. 

If you change chi? name of Che Prefix diskette, the volume name that 
tlje aystcr4 supplies as Prefix is also changed. Sliifilacly, if you 
diaiige the name .if the "system'* or "mot" diskette, the nsuie that the 
system supplies Eor the asterisk C * ) volume-specifier is also changed. 

The file F5.TEXT is on the diskette fn disk drive volume flS: 

Prnnqit: CHANGE tfJiAT FILE 7 or CHANGE f 

iTdbponse: tf5:F5.TEXT 

When you press the RETURN key, the dialogue continues: 

ProEupt: CKAT'JfiE TO WHAT ? 

Response: HOOHAII 

Typing the above response changes the name in the directory from 
F5.TE>:T CO HOOHAH . Flletypea (such as TEXTFILE or CODEFILF^) are 
originally deternined by the filename's suffix (such fls -TEXl or 
■ CLfDE ). The C(hange command does not affect the filetype, but it 
also does not automatically place the correct standard filetype suffix 
after [he new filename- In che above case, llGIUIAH would still be Hated 
as typo TKXTFILE by an Efj^Cended directory Hat- However, 
since the Utet coranand searches for C|ie suffl:. -TEXT In order tu 
Identify a te^tflle ds the workflle, you Would tiave to C{hange the 
filename ItUUflAlT to KOOhAJi . TEXT before tliat file ct-nld be uaed as the 
JorkfliCi 
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Wildcard apecJ Cleat iOEis are legal in the C(hflnge canmand, Tf a 
wildcard character l3 used in the first file specif i cflCion, then a 
wildcard eoibc be uaed in the second flic apec] f i cat ion. The subaot- 
sptclfying sdrings in Che ilrst. file apeci fi cation are TEplaced by thsf 
analoyous sttin^B (hencefccward called replflcenfent atrlnga) given in 
Che second file apecl f ICflClon- The Filer will not change the filename 
if the cUanye would hove the effect of mfllting the f i lenanie too long 
(mare than 15 charactera). 



EXAMPLE: 

The diskette named HYDISK: contains these flLeas 

CHAPUTEJCT 
CHAP2.TKXT 
CliAPT£H-3.TEXT 

CHAF4.TEXT 

Prompt: CHMtE WHAT FILE '.' or CEtAWGE ? 

Reaponae; rtYDlSK:C=XT ,OLDC=XT 

After you typed the above respnnBe {the two pacts of the response were 
separated by a caimiia, this Cime, but you could also preas the RETUEUJ 
key Co aeparate the reapunges), the Filer would then Indicate the 
fallowing nacne changes. Only the files' fllenaraes ace changed; the 
contents of Che files CheniBclveB are left unoDdifled* 

mydisk:chap1.text 
— > olljc;hapi.text 

MYDISK:CliAP2,rJi:XT 

— > 0LDCHAP2.TEXT 
M VU 1 S K ! CHAPTER- 3 . TEXT 

— > NOT PHaCESSED 
MYDISK;CEAPA,TEXT 

— s OLD :]HAPi. TEXT 



. 1 



1' 
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!□ the third atteoipted nairie change, the ^'deati nation" filename would have 
been 0LDCE[APTER-3,TEXT, which e>:ceftdG Clie l5-character limit for fi lenamea -^ 
Therefore, that file was "NOT PROCESSED" , If all of the ^'desti nation" 9" 

f ilciamCB exceed 15 characters, this additional mefisage la given; 

BAD DEST TOR FILES FOUND 



The ^ubset-flpecifying atciags may be eoipty, as may the replacement 
strings. The Filer considers Che one-character file specification = 
twhece both suhaet-apeclfylng stcings are empty) to specify evecy file 
on the diskette. 
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EXAMPLES : 

PcoDipt! CHANGE WHAT FILE ? or CHANGE ? 

Keapoaaefl: =,Z^Z 

Typing this response would cBuse every filename on the Prefl* 
diskette to have a Z added befoce the first character and after the 
last character- 

Reaponsetfl: Z'=Z, = 

Typing this response would fagain, on the Prefix diakettej erase Che 
tecEuinal and initial Z from each filename that posBEtiSed both. 

Suppose the Prefix diskette contained theae filenames: 

THIS. TEXT 
THAT. TEXT 

Responaetfa; T-T,- 

Typlna responae *3 wonld result in changing THIS. TEXT Co UIS.TEX , 
and THAT. TEXT Co UAT.TEX . 

ReHponseffi: -.lEXI,OLD-= 

Typing this response would add the prefix OLD. to every fllenarae on 
the Prefl^L diskette, and remove the aufflx .TEXT from every filename. 
CHAPl-TEXT would thus become OLL.CHAPl , and CHAP2.TEXT would become 
C^LD.CHAPZ . ThJs would quickly niark all your old versions of a file 
and simultaneously iDake Chnae versions safe from accidental accefls by 
the (i(et coiEimand' 



The diskette's volume name may also he changed, by specifying Che 
current diskette volume name or number and (after a comma or RETURN) 
new voluine name for the diakette- 



EXAMPLE! 

PcDdipc: CHANGE WHAT FILE ? or CHANGE 7 

Respunae: NOTSAfJE: .WRKDISK; 

Typing this response would cause the system to give thia mpBaage: 

NOTSANE: — > UKKDISK; 

showing that the diskette named NOTSANE: hds been rerramed WRKDISK 
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R(emove 



Removes £ Lie entries frmn Che directory, vhich nakes Chose dlakette 
EiLes inflccPHBlble. While a cemaved file's conCenta are still acored 
on the djHkeCCe, and IL inay aomeCline-] "be possible tn recover tJiem In 
an emergency (see M(eke )■ the BysCeni acta es if g removEd file had 
been erased from the dlaluzCte. That area of the diflfceCte Is Chen 
considered free for Dverwricing with other files. 



typing this response Causes the Filer to remove AHAZlN(^.COP£ and 
ANDROID. CODE from the Frefis diskette dicecCory. 

WARNING: Remember that the Filer considers Che one-charactet file 
specjf icdtlon - (where both aubeet-speclfylng strings aro empty) to 
specify every file on the ^^luiAe- Typing an ^ alone will cause the 
Filer to remove every file on your dlrecCoryl 



This command requires one file specification foe each diskette file 
that you wish to remove- Wildcarda are legal* Size apeclElcatlon 
Informa tion Is ij^ored> 



SZAMPLE; 

Suppose Che Preflst diekette conCalno these files: 



Prompt 1 



AARDV ARK 'TEXT 
ANDROID, CODE 

QUINT. TEXT 
AHAiiING -CODE 



RH10VE WHAT FILE ? or RtMOVE 




Response- flMAZlNC-CODE 

Typing this response celts the system to remove Che file AMAZING. CODE Hi ^ 

from the Prefix diskette's directory. The syHtem then considers Chat file*' "" 
erased from thp dlskecte* although only the directory has been changed. 



T 



To rerflove SYSTEM. URK. TEXT and/or SYSTEM.WRR.CODE , the Filer's Nfew 

ccnimand should be usqd, or the sys teiu may get confused- IT IS VERY ^ki 

IMPORTANT TO REHEMBER THIS LITTLE QUIRK, BECAUSE THE SVSTEM WON'T WARN YOUBI 

As noted hefore, uildcatd removes are Eegal- Fortunately, before 
finalizing any wildcard removes, Che Filer asks if you wish to 

UPDATE DIRECTOKV 7 

Typing T In response to this prompt caujies all the specified files to 
be removed. Typing N returqs you to the outer level of the Filer 
vitbout any removes having occurred. 



EXAMPLE^ 

Frompc: HI^OVE WHAT FILE ? or REMOVE ? 

Response; A-CODE 



K(runch 

Moves the files on the specified diskette volume so that unused blocks 
are combined. "You use this when you run out of space or seem ahauc 

to, because Che unused space on the diskette Is Erugmented. Using the 
Efxtended directory list command to list Che directory will show you 
how the unused spa^c is distributed fin the diskette. After typing K, 
all Che unused space will be together at Che end of the diskette (or 
aC soiiie oclier place on the disk, gpeclfJed by you). 

This cDimnand requires that yuu type a diskette volume name or number. 
The specified diskette volume must be on-line {currently available to 
the syatem)- IC Is a good idea to perform a had block scan of the 
volume before Ktrunching, Co avoid writlna files iiver bad areas of the 
diskette. If bad blocks are encountered, they must be either fixed 
or Diarked before the K(runch (see X(amlne ), 

As each file is moved, its name is displayed on Che screen- If 
S¥STEM,PA!iCAL is moved, Che system must be relnlclallied by booting- 

WARNING! Do not touch the disk, the RESET key, the power switch or Che 
diak-driva door until KCrunch tells you it has completed its task. To 
do otherwise may make the informaclon on your diskette unreadable- 



EXAHFLE; 

Suppose you wish to Ktrunch the hoot diskette: 

Prompt: CRUNCH WILAT VOL ? or CRUNCH ? 

Response: * 

You could also have responded with Che volume number { tf^: ) or the 
Volume name of the boot diskette, of course. 

-^ Frompt: FROM END OF DISK, BLOCK 260 ? CY/N) 

Typing the response Y Initiates Chti normal Xfrunch, Typing an N will 
cause Che prompt: 

Prompt: STARTIN;! A1' BLOCK ff ? 
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If you type a block number In rEaponBe to this prompc, the Filer will 
atCenpt to make room for new file*! In Che area surrounding the block 
nuDber chat you apeclfled- IC daea this by raovlng files forward 
(tovacd lower block numbers) which are belav the speclfiEd block, and 
TDQvinfi fllBH backward (toward higher block numhecij which are above the 
specified block. This feature allows you to ro-3rrange files, by 
placing Chem at diskette locations other than the end of the dlakette- 

Noce: If you specify a Rninch atartins block that is clearly within an 

enlstinE file, but the Flier Colls you Che diskette is already Kmncbed, 

jufit try ag^in with a starting block in the next hlgher-blodk-nUofcerQd 
file- 



Z(ero 

"Erases" the dlreccory of the specified volume (by writing zeros Into 
It). The prevLoua directory la rendered Irretrievable. Thia la used 
to ^'recycle" ^ used diskette; the system forgeta anything previously 
stored on the diskette and the diskette is ready to he ueed again* 
This command does NOT fonoat the diskette: the diskette rauPt already 
have been formatted by executing the FORMATTER utility program (see 
thla manual's chapter UTILITT PROGRAMS). 



EXAMPLE: 

Suppose you wish to forget all infonnatlon stored on a diskette named 

OLDDISK, in disk drive volume *5: , In order Co re-use it as a clean» 
blank diskette- 
Prompt: ZERO DIR OF WHAT VOL ? or ZERO DIR OF ? 
Response: ^^ : 

Prompt: DESTROY OLDDISK: ? 

Response: Y 
Prompt: DUPLICATE DIR ? 

Always respond to this prompt by typing an N response, which ullJ 
^ause the usual single directory to be maintained* The Apple Pascal 
systeiQ does not support duplicate directories! Next you will see; 

Prompt: ARE THERE 28f! BLKS OP TtfE DISK 7 (¥/N) 

Response: Y 



h 

ft' ^ 



The Apple Pascal system uses only 2Sja-block dlskettea, so your anewer 

CD this pcorupt should always be Y for "Yes". Each dJaketCe'a 
directory contains the mimber of the blockfi on Che diakeCCe- If your 
system ever aaka 

ARE THERE 1H*(J flLKS OH THE DISK ? (Y/N) 

(or any number other Chan 2S0J , the diskette's directory Is probably 
damaged. 



Now you will be asked to name the newly-aeroed diskette: 

Prompt: NEW VOL NAME ? 

Response: HEWDlSK: 

(or you can type any other valid volume namej; and Chen you vlll be 
asked to verily the new name- 

Pronqjti NEWDISK: COKRECT 9 

Response: Y 

Typing a ¥ response to this prompt causes the Filer to respond with 
Che message: 

MEWDISK: ZEROED 



WORKFILE COiVlMANDS 



G(et 

Identities the deE^anated diskette file for IsCer use as the 
workfJIe. The neit time yon atCenpt to Edit. Compile, or Hun, the 
designated file will be ussd. At that time, IE the JesiEnaCed file 
in 110 longer available Co the sysCeia this messaj^e la given: 

ERROR: WORKflLE LOST* 

Mote: Althouah you are told Chat the specified file has been "loaded", 
this connnand doefj NOT actually transfer thp spei:lfied file to the hoot 
diskette file named SYSTEM. WRK (or to any other file). The file 
SYSTJilH.WR]: ]& usually created by Updating the uorkfile from the Editor 
(see this manual's chapter THE: CGtll'lAND LEVEL far oiore information 
about Che workfile, and tho chapter THE EDITOR for more inf urniflt Ion 
about the EdlLor)< 
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Cne-drlve note: In one-drfve aysteins, since your boot diskecce 
(usually APPLET*:) iouhc be In the drive to Edit, Compile, and Run the 
deElanated workflle, you cfln only effectively G(e[ Ellea chat you hflve 
previniialy T transferred to your boot dJslteLCe- 



If Chere la already 3 workflle SYSTEM-WRK present on che boot diskette 
when you isaue Che G{et coiomantl, you are prompted: 

THKOW AWAY CUBRENT WOHKb^II.E V 

Reaponsc; Y will clear the workfJle, removing all files SYSTEM. WRK 
from the boot diskette, wlille N returns you to the outer level of 
the Filer- 

Typlnii the f 1 loniiine's suffiit in Che file apeclf icatlon is not 
necessary. If the volucie name of the diskette is not given, the 
Prefix diskette la aaamned. Wildcards are not elloued, and the ai^e 
apecif Icat Jon option la ignored- 



EXArtPLEi 

Suppose the Prefix diskette conta.ina the followinE Eitea: 

FTLERD0C3.TEXT 

AflSUHD.CODE 

irYTYPER.CODE 

STASIS. TEK.T 

LETTEHl.TEXT 

FILER. DOC. TEJCT 

STx^alS.COOE 

Proiiqjt: GET WILAT FILE ? or GKT ? 

Response: STASIS 

The Filer respond<i with the tneaaage 

TEXT b CODE FLLF, LOADED 

alnce both test iind code file ex.Jflt. Had you typed KTASlS.TEXT or 

STASIS. CUUE , the result would have been the same: both cent and code 
VersloTiH would have been Identified for later ube as the workfile- If 
only (jne of the versione exists, as In the case nf AflSQHD .CODE, then 
that version ia identified for later workfile use, regardlesa of 
vhecher teict or code w-jh rtqueated. Typing AB.SIIRD .TE^^T In response to 
the prompt vould jjeneriite the liiesaaBe: CODE FILE IjOADED . Working 
with the workfile TJiay create a nuniber of files whose names begin 
SYSTEM. WWK, , as parts of the workflle- These files will disappear 
when the Stave command 3a used to aave the contents of the workflle 
under their original filename or under a new filename. If the systeui 
la rebooted before Che Sfave comuwind is used, the original fwme of the 
workfile'a contents fas specified by the G(et coTi&aand) will be forgotten. 






i^ 






[3 
1^ 



S(ave 

Saves all verslora of the booE diskette's workfile SYSTEM-WRK under 
the filename originally specified with Gtet or under a different 
filename which you specify. 

If a file already exlata with the specified filename and If you are 
SCavlng your file onto a diskette other than the boot diskette, you 
are asked for verification beEore che old file Js rerwived- In that 
case, the workfile ia saved under the specified name only after the 

old file has beer removed- 

If you dre S(aviag the workfile as another filename on the boot diskette, 
the workflle (which is already on that diakette) is simply renamed- 
When you S(ave the workflle on a diakette other than Che boot 
diakette, the syHtem is actually performing a Ttranafer of the 
workfile, ThuB Che workflle is unchanaed after the S(ave Is comploted- 

The entire file flpeciflcatlon la not neceaaary. In particular, DO NOT 
specify a auffix. The correct aufflit for each version of the workfile 
( .TEXT, .CODE, Etc-) is supplied automat J caLly, in addition to sny 
suffix that you might type- Unlike many parta of the system, ending 
the specified filename with a period does NOT QUppreaa the addition of 
a suffix- If the diakette volume name or number is not alven, the 
Prefix diskette Is aaaumed. Wildcards are not allowed, and the slie 
specification option is ignored. 

Line-drive note? Even on one-drlvc aystems, S(ave works Just fine if 
there ia only one version of the workfile. if you Stave the workfile 
onto a diskette other than the hoot diskette, the Filar will prompt 
you to put che destination diskette into the drive at the correct 
time. However, only the FlkST version of the workfile (usually -TEXT) 
is SUved onto the dtjstlnflcion diskette. If the Filer returns to the 
boot diskette to get another version of the workflle (-CODE, say), the 
boot diskette Is not in the drive and the command is terminated. If 
you want to Stave MORE THAN ONE version of the workflle t.TF-XT and 
-CODE, aay), first Stave the workflle onto the boot diskette. This 
renames the wurkflle versions and tolls the system that your workflle 
is gone, T}|EN T(ran3fer Che S(aved versions onto your desCination 
diskette, one version at a time. 

EXAT-lPLE; 

Prompt: SAVE flS HYDISK:OLDFILE 7 



Response: N 



Prompt: 



SAVE AS WHAT FILE 7 or SAVE AS 7 



Reaponse: Type a filename of 10 or fewer characters, observing the 
f i lenane conventiDna discussed under FILES fearller In this chapter). 
ThlB causes the Filer to remove (after asking you for verification) 
any old file haviia the specified filename, and then to save the 
workfile under that name- for example, typing X in response to the 
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prarapc causes the uockflle to be anved nn Che Prefix diak as It. TEXT - 
If H codeflle has been compiled or aaserahled nlncc the last update o£ 
Che workfJle, Chat toiieflle will also be aavtJ, as K,CODE . 

The Filer aaCOffiaticfllly appends the suffixes -TEXT and -CODE to flltiii 
of the flppropfiaCe Cype. Explicitly Cypins AFILE.TEXT in response to 
the prDmpc will cause the Filer to aave this file as AflLE-TEXT.TBXT 

EXAMPLE: 

PrnmpC: SAVE AS WHAT FILE 1 or SAVE AS ? 



dlaketLe named RED: * you will 



Keflpoaae: StEUiEVE 

If one of your disk drives contains 

BODQ see thv measaae 

APPLEl: SYSTEM. WRK. TEXT 

— > RED: EYE-TEXT 

This ineaaage tells you that the wocKfile named S Y STEM. UBK. TEXT , on 
the boot diskette named APPLEl: . has been successfully rranaferred Cd 
the file nanied EYE. TEXT , on the diskette named RED: . If there Is no 
diskette named RED In any dislt drive, you ^Jlll aee Che mesaage 

PUT m RED: 

TYPE <SPACE> TO CONTIKDE 

ThiB alvea you the chance to insert a diskette naraed RED , If you have 
one into a disk drive. BED:EYE cnnatltutes a file specification, 
and thia feaponae will tell the Filer to attempt to bransfer che 
workfile to the specified volume and file (aee the Tiranafer coranand). 
If you specified diskette RED: by accident, preaa the apacebac anyway. 
The system will not find diskette BED: , and the command will be 
terminated. 



EXAMPLE: 

Suppoae you earlier used che GCet cotimand Co designate the file 
MYDISK:LETTER as the next wotkfile, Ycju then Qfult the Filer and 
entered th^ F;(ditor. cauainj^ HYDI3K: LETTER- TEXT to be read Into Che 
computer- Finally, you added aone new inacerlal to the file, and then 
used the Editor's Q<uit and U(pdace i^oiiinands to store the new version 
of the file on the hooC diskette as SYSTEK.WHK.TEXT - 

How. back m the Flier again, you type S for S<ave and receive this 

prompt: 

SAVE AS MTOISKiLETTEE ? 
If you type a Y , the Filer first asks 

REMQVE old MHJ is Ki LETTER, text J 



B! 5 Typlna another Y cauaea your previous version of LETTEH,TEXT to he 
' removed from HYDiSi:: , and then causes Che new version (stored as 

APPLEl:aYSTEM.WRK."EXT ) to he saved on MYDISK: 

H^ 5 AJ^PLEI; SYSTEM. URK. TEXT 

^ ' -_> jfYClSKtLETTEE.TEXT 



N(ew 

Clears the workflle. so that there Is no default file to be used 
aucocaticatly by E^dlt. C<ompUe. A^Bseioble. and R(un . The l^st file 
anecitled as the ^rkfile by the Filer's C(el connnand Is no longer so 
dUmnated. All versions of the -orkflle SYHTEM-WPK saved on the boot 
diskette are removed from Che directory (SYSTEM.LST.TEXT is also 
removed}. There will be no workflle on the boot diskette until a 
workflle is saved (usually using che Editor's D(pdate command). 

If there la already a workfiU SYSTEM.WBK present on the boot diskette 
when you issue Che N(ew coranaod, you arc prompted! 

THROW AWAY CURRENT WORKFILE 7 

ftesponae: Y wlU clear the workflle, removing all files SYSTEH.WHK 
from the hoot dlatetce^ while N returna you to the outer level of 
he Filer- 



m 



I 






ii 







Use the N(ew command to clear away the autoipatlcally-loaded workf i le 
before you try Co create a new file In the Editor or Compile any file 
IJ3 other Chan the wockffle. 



^ 



W(hat 

Idenclties Che nane and state {saved or notl of the workflle- 



g ^ 



If Che workflle h^s been Sfaved onto any dififcEtCo other than the boot 
disketce, the W(hat coimnand continues to report the workflle as (NOT 

»J SAVED). This is because th,i workflle still exists on the boot 

y diskette. 



u 







INFORMATION COMMANDS 



V(olumes 



Lists Che input and output volumes (devieea or dlskecces) currently 
m "on-line" (actively connected into the system), by volume name and by 
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A typical display for a ejngle-dcive syaceia, with few perlpherfllB 
ml ah t be: ' 

VOLS OW-LINE: 

1 CONSOLE: 

1 SYSTERM: 

1^ if APPLEfl: 
ROOT Vai IS - APPLEB: 
PREFtX IS - APPLE0: 

The VDlumefl CONSOLE; and SYSTERM: are always available. They are iuei 
tva different ways to refer to the screen and the keyboard- 

A four-drive ayHCem, with a printer and with a mdcin for coirmiualcacina 
over telephone lines, nlghc give a display like ChlsJ 

VOLS ON-LINE: 

1 CONSOLE: 

2 SYSTERM: 
A fl APPLE f: 

5 9 APPLEZ! 

6 PRIWTEH : 

7 HEMIN: 
S BEflOUT; 

11 it APPLE3: 

12 » JEF: 

BOOT VOL IS " APPLHlt 
PREFIX IS - JEF: 

The boot dlaketce, alfia called the aysteni volume^ is indicated here ss 
the ROOT VOL — itt this case Che diskette nfliaed APPLEl: , In disk drive 
volume tf4i . The default volume le indicated here as the PRI-FIX volume 
— in ChiB case it has been changed by the Pfrefix command to JEF: , 
the name of Che diskette in disk drive volume ffl2: - lr\ general, the 
Prefix volume will be Che aame as the hoot volume unless the Prefix 
(see the PCreflK command) haa been changed. Rlock-Etructured dovlcee 
Cdisks) are indicated by a "pound" sign ( tf )- 



Uist Director/ 

Lists a diskette's directory, or pace of one, to the volume and file 
specified {default la CONSOLE: ). All files and unused areas are listed 
along with their block length and last loodification date* 

You nay list any portion of the directory, using the 'Vlldcard" 
option, and may also write the directory, or any portion of it, to a 
volume or filename other than CONSOLE: . This ia why you must 
sometimes give both a source file specification and a deatlnaclan file 
flpecificatlun. The destination file Hpecifl cation should NOT include 
fl wildcard- 



■ 

E 



Source file specification cooslsts of a mandatory disk volume name of 
number, and optloaal wildcard and subset-specHylng atrltigs which ma? 
be empty. The source file specification must be separated from a 
destlnstlon file specification by a comma ( , )■ Destination file 
BpecIficflClon consists oE a volume name or number and. If the volnme 
is a disk, you MUST include a fllenane- 

A directory listJne stops when it has filled the screen- Press the 
spacebar to continue the listing, or press the ESC key to abandon the 
liHClng and return to the Filer prompt line. 

EXAMPLE: 

The most frequent use of this command is to list an entire diskette 
directory on the screen- The EoUowinB display, which represents a 
complete directory listing foe an example diskette APPLEfl: . could be 
generated by typing any valid volume name or [^unbet tor APPLET*: In 
response to the prompt, 

or DIR LISTING OF ? 






3 

^ 



J 



ProDiot : 



Reapoase; 



DIR LISTING OF WHAT VOL 

fli: 

APPLEfl: 

SYSTEM-PASCAL ^6 

SYSTE^'-MlHCINFO 1 

SY;^T£K- COMPILER 71 

SYSTEjM. EDITOR A5 

SVSTEH. FILER 2fl 

SYETEN-LIJIRARY 36 

SYSXEH-CIIABSET 2 

SYSTEM- SYNTAX U 

TUN AF:Sh. TEXT 4 

SYSTEH.WRK-TEXT 4 

SYSTEM. WRK- CODE 2 
U/ll FILES, il UNUSED, 



4-HAY-79 

'►-MAY-?^ 
3a-MAY-79 
29-JAN-79 
2i-MAV-79 
22-JUN-79 
U-J[JN-79 
18-APR-79 

a^JUL-7!» 
17-JTIL-79 
17-JU[.-79 
23 IN LARCEST 



The bottom line of the display loformB you Chat II files out of a 
total of II filea on the diskette have heen listed, that there are 31 
out of a total of 280 diskette blocks left for you Co use, and that 
there are 23 concigoous blocks In Che largest unused area on the 
diskette- The first ratio shows that you are looking at a complete 
listing of the diskette's directory, and not a partial listing as 
discussed below, Tlie last nucnber shows the size of the largest file 
that you could now store onto ^-hls diskette- Even though Chere are 31 
unused blocks available on the diskette, the laraeat file you could store 
would be 23 blocks, because a file must be stored in contlguoos blocks- 



K J ji^ EXAMPLE: 

Here Is a L (Is t-di rectory transaction Involving wildcards. 



& d 
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Proqipt: DIft LISTING OF WHAT VUL ? or DIR LISTING OF ? 
I Response: tf4:S-R 






Typing the response ahove mlEht geaerflte the follawdng display; 

APPLE0! 

SYSTEM. COMPILER 71 30-MAY-7g 
SYiiTEH. EDITUR A5 29-JAH-7g 

SYSTEM. FILER. 28 2^-f'lAY-7g 

3/11 FILES, 9i UNUSED, 9Z IK I4ARGEST 



^ 



A partJal listing oE a directory flSsEinpg chat Che last file Usted is 
the laac filQ on Che diskette, and usea Chat assuntptlon in calcuiat Inp 
Che nuTTiber of unused blacks remaining on tho diskette beyond Cho laat 
listed file- This faulty assunpCiDn usually fil vea an incorrect number 
of unused blocka, and an Incorrect siie for Che largest unuaed area. 
This la only a prublera on partial llsclngs; complete llstlneB give the 
correct nuinberfl- 

£}CAMPLE: 

This LUst-dlrectdty transaction Involves i^ricinE a subset of the 
directory to a device other than the default CONSOLE; 

Froiupc: DIH LISTING OF WHAT VUL ? nr DIK LISTING OF ? 

Keaponse: Af PL E0:!i'=R, PRINTER: 

Typing the ahove response causes this message: 

APPLE0: 

SYSTEM, COMPILER 71 i-MAY-79 

SYSTEf-l.F-DlTOR i5 29-JA31-79 

SYSTEM. FILER 28 2ft-MAY-79 

3/11 FILES, 93 UWUSED, 93 IN LARGEST 

to appear on the printer Hi you have a printer, and If it wa& Cumed 
oiii). Ic's that easy. The number of ununed blocks la sciU wrong, 
since [Ills la a parcial directory llaCinE- 

EXfiS-WLEl 

Thla hCint-dlrectory tranaactlan involve*! writing the directory Co a 
dlekr 

Prompt! DIR LISTING OF WHAT VOL ? or DIR LISTIHG OF ? 

Response: tfi: Ji: DRCTRY-TEXT 

After tyfilng this response, you will see the ineasaae 

WRITING 



T 

w^ 

^ 



as the Filer creates Che file DRCTRY.TEXT on the diskette In disk 
drive #A! . This file would contain the entire directory of the 
diskette In drive ff4! , as it looked BEFORE the file DRCTRY-TEJa was 
edded Co IC' 



E(xtended Directory List 



t-a 



Lists the diiectcry of a diskette, giving iDore detaJl than Che L{iBt- 
dlrectory commanc All files and unused areas are listed along with 
(in chls order) their block length, last modification date, Che 
starting block addrsss, and the filetype. 

This coEBDiand takes a liccle longer than the L (ist-dlreCtory command, 
but in givea imporcanC extra Information about Che distribution of 
files on your df<ikeCte' 

The prompt lines, syntax, and wildcard options are exactly the same for 
ChJa CDirnaand as for the L flat-directory command dlscuaaed above* For 
more details and examples* look at the L(laC-dlrectory discussion. 



EXAMPLE: 
Bl~ ] tm An example display for a diskette AFPLE0: , also shown In the 



m^ 



previous L^lsc-diractory dlscuaalon, la shovu below- 



m ^ 



Prompt: 



UIR LISTING OF WHAT VOL ? or DIR LISTING OF 7 



Response: 


fiA: 
APPLES: 












SYSTEM. PASCAL 


36 


4-MAY-79 


& 


DATA 




SYSTEM. MISC INFO 


I 


A-MAY-79 


42 


DATA 




SYSTEM. COMPILER 


71 


30'MAY-79 


43 


CODE 




SYSTEM. EDITOR 


A5 


29-JAN-79 


lU 


CODE 




SYSTEM, FILER 


Z& 


24 -MAY- 7 9 


159 


CODE 




SYSTEM. LIBRARY 


36 


22-JUN-7g 


1B7 


DATA 




SYSTEH. CHAR SET 


2 


U-JUN-79 


223 


DATA 




SYSTEM. SYNTAX 


li 


18-APH-79 


225 


TEXT 




< [SNUiED > 


4 




239 






TUN AFLSH. TEXT 


4 


a-JUL-79 


243 


TEXT 




< UNUSED > 


4 




247 






SYSTEM. WRK. TEXT 


4 


17-JUL-79 


251 


TEXT 




SYSTEhl.WRK.CODE 


2 


1 7- JUL- 7 9 


255 


CODE 




DRGTRi:-TEKT 


4 


ie-JUL-79 


257 


TEXT 




< UHU.SED > 


L9 




261 






12/U FILES, 27 


UNUSED 


, 19 IN LARGEST 





If you are using Che Apple Pascal system with an external terminal 
whose screen shoua an 80- character-wide, upper-and-lower-case display, 
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your directory lla^lng will appear somewh^C 
shown above- The same diskecce directory, 
uQuld look more like Uila: 



different trom the one 
If Hated on your syatecn, 



APPLET! 
SYSTEM, PASCAL 
SYSTEM, MISCWFU 
SYSTEM, COMPILER 
SYSTEM, EUITOR 
SYSTEM, FILER 
SYSTEM. LIBRARY 
SYSTEM. CHARS ET 
SYSTEM. SYNTAX 

< UNUSED > 
TtJNAFISH,TEKT 

< UNUEEU > 
EYSTEM-WRK.TEXT 
SYSTHH,WKK.CODE 
DHCTHY. TLXa 

< UNUSED > 
U/12 files<lls 



36 
I 

71 
45 

"b 
1 

U 
4 
4 
4 

2 

4 

19 



4-May-79 
4-May-?y 
30-Mdy-79 
a9-Jan-7y 
24-Hav-79 
22-Jun-7g 
U-Jun-79 
i&-Apr-79 

e-Jul-79 

l7-Jul-79 
17- Jul- 7 9 
ia-Jul"79 



6 
42 
43 
lU 
159 
187 
223 
225 
239 
243 
247 
251 
255 
257 
261 



512 
512 
512 
512 
512 
512 
512 
512 



Dfltaflle 
Dacafile 
Codefile 
Codcf i U 
Codefile 
Datdfile 
Dacafile 
Teatflle 



ced/in-dlr>, 253 blacks 



The exEra column of Dumbers gives Che numbe 
block, of each file- This number 1b almost 
aumbet of bytea per block- 



EXAMPLE i 



512 Textflle 

512 Texcfile 
512 CodefUe 
388 Textflle 

uBed, 77 unused, 19 In largeuE 

r of hytefl need in the last 
always 512, th? Daxlmum 



Here la an Etxteaded-dltectory-Iiat CranHactlon that llstH d partial 
directory by uaine a wildcard in the filename specification, 

Pconpt: DIB LISTING OF WHAT VOL ? or DlR LISTING OF 1 

Response: #4:S'-R 

l^yplafi the responae above might generate the folloulng display; 



APPLE0: 

SYSTEM.COMPtIEK 
SYSTEM- EDITOR 
SYSTEM. FILER 
<- UNUSED > 



71 ^a-MAY-79 43 CODE 

45 29-JAS-79 lU CODE 

28 24-MAV-79 159 CODE 

93 IS? 



3/12 FILES, 93 UNUSED, 93 UJ LARGEST 



A partial liBtlng of a directory aaaumes that the last file Hated Is 
the last file on the diskette, and uses that assumption in calcjlatiog 
the number of unused blocka remaining on the diskc^tte beyond the la^t 
listed file. This faulty assumption usually gives .^n Incorrect micober 
of unused blocks, and an incorrect nize for the largest unused area, 

Thla le only a problem on partial llBtiaga: complete listings gi^^ the 
cocrecL numbera. 
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" DISK UPKEEP COMMANDS 



B(ad Blocks 

Scans the specified disk volune and detects bad blocks, hy comparing 
the recocded checkaum for each black with the actual Information 
stored In the block. 

This coinmand requires that you type a volume name or number- The 
Bpecified disk voiuiDe must be on-line (currently available to Che 
aystemj . If the disk drive oc diskette is not Cherej the message 

NO SUCU VOL ON-LINE <SQURGE> 

will appear. You can Just Ignore Che last word. 



EXAMPLE: 

Prompt! BAD BLOCK SCAB OF WHAt VOL ? or BAD BLOCK SCAN OF 7 

Response: AP?L£0: 

Prompti SCAN TOR 280 BLOCKS ? (Y/NJ 

In reaponae you vlll norofilly type ¥ for "Yes"i telling the Filer 
you want to scan the entire diskette- \l you wish to check only a 
smaller portion of the disk (a very unusual case), type N and ynu 
will be aaked Cfl type the number of blocks you want the Filec to scan. 

Note: The Apple Pascal System uaea only 280-block dlsketteBi flo you 
can always answer the question 

SCAN ?UR 2flS) BLOCKS 7 (Y/NJ 

with a Y , Each diskette's directory contains Che number of blocks on 
that diskette- [f your syscem should ever aak 

SCAN fOR 1134 BLOCKS ? (Y/N) 

(or any numbec other than 280), the diskette's directory ia probably 
damaged* 

When you type Y , the system then checks each block on the Indicated 
diskette volume for errors, and Hats the block number of each bad 
block- The measaga you will see at least 991 af the time Is this: 

SCAN FOR 2B0 flLOCKS ? (Y/NJ Y 
BAD BLOCKS 

Very rarely, however, the disk drive will buza and clatter, and you 

may see a utessage similar Co this: 
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SCAN FOR Zaa BLOCKS ? {Y 


/N) 


BUJCK 23 IS aAD 
BLOCK 24 IS aAD 
BLOCK 25 IS BAD 
i BAD BLOCKS 




FILEU) ENDANGEIRED: 

THISFlLE-TEXr Ifl 


24 


THATFILE.CODE 25 


2*5 



gn^ 



The last line tells you that the three bad blocka ace rcntRlned partly 
In the file THISFILE-TEXT , i*Ich is atoced in blocks L8 through 24 , 
and partly 1q the file THATFILE-CODE , which occupies blockfl 35 
[hcDugh 29 ■ Blocks reported as "bed" can often be fixed, using the 
JCCanlne conuiand. Those which cannot be fixed can be "reserved" to 
Avoid their use- See the X(aDine command, ^^ich follows this 
dlBCueBian* for a moce coo^Iete eKample of this ptoceas. 



X(amine 

AttenptB to "£ix" euapected had blocks on a dlakBtte (bad hlocka are 
found by uaing che B{ad-blocks command)* The eXamlne connaTid Is 
invoked by typing the letter X ■ 



This coiTaiiaiid requires that you type a disk voIueie name or nniaber- 
specified disk volume doist: be on-line (currently available to the 
syatem). 



EXAMPLE: 

Suppose you have Jast done a B(ad-blks scan of the diskette named 
HYDtSK: , and the Filer has given you the following Tueaaage: 



The 



SCAN FOR 


280 BLOCKS 


t 


iY/N) 


BLOCK n 


IS BAD 






BLOCK 24 


IS BAD 






BLOCK 25 


IS BAD 






3 BAD BLOCKS 






FILE(S) 


ENHANCE A ED: 






THISFILE 


TEXT 


18 


24 


THATFILE 


CODE 


25 


29 



Now you have typed X to initiate the eXamlne coiMiand- 

Pronpt; EXAMINE BLOCliS ON WHAT VOLUME 1 or EKAHIHE BLOCKS CM ? 

Response; Mn>XSK: 

Prompt: ULOCK-RANCE 1 

AC chla point, you should have just done a bad block scan (using the 
B(ad-blkB counuand) , and flhould enter the block number returned by 
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1 
1 
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1 
■ 



ft 



•3 



r 



3 



the had block scan- If Eoore Chan ana had block was reported, type Che 

number of the first bad block, followed by a minus sign, followed by 
the number of the lasF bad block' 

keeponae; 23-25 



-^ If any Clles are scored on the area of the diskette occupied by Che 
l3 blocks you -are about to eXamlne, you uill be cold Che name of each such 
tile and ica beginning and ending block numbers: 



Prompt: PILECSJ EHDAHGRRED: 

THIS FILE, TEXT 
tHATFILEXODE 
FIX ThBM t 



18 
25 



24 
29 



Note: The filea shown are endangered merely by their containing bad 
blocksi NOT by the eXamlne process. AlsOi the question FIX THEM ? 
refers to the specified bad blocksi not co Che filea> 

An N response to this prompt [etuma you to the outer level o£ the 
Flier- If you type a V in reaponse to the shove proEopCj you will 
cause the Filer to examine the blocks in the range you specified- The 
Filer will then usually return a focsaage like this: 

BLOCK 2^ MAY BE OK 
BLOCK 24 HAY BE OK 
BLOCK 25 MAY BE OK 

in which case the bad blocks have probably been fixed- Occasionally, 
however, Che Filer may return a mesBage like this: 



BLOCK 23 MAY BE OK 






BLOCK 24 IS BAD 






BLOCK 25 f 5 BAD 






F1LE(&) ENDANDEBED: 






THISFILE,TEXT 


la 


24 


THATFILE -CODE 


2^ 


7^ 



MARK BAD BLOCKS 7 (FILES WILL BE REMOVED 1) (Y/H) 

In which case the Filer is offering you the option of marking the 
block(3) which it could not fix* If you type a V reeponae to this 
prompt, the filer first removes all files containing Chose bad blocks 
that could not bt fived- It then creates a special file on the 
diskette, nemed BAD , which exactly covers the bad blocks (or more 
Chan one such fiLe, if Che bad blocka are not contiguous) < This 
DeasBge then appears: 

BAD BLOCKS MARKED 

and you are returned Co Che outer Filer level- On the dlakette, there 
is now a new directory entry saying 

BAD. 00024. BAD 
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Blockfl In a file mflfked «BAD will noc be used to state any of jo\ic 
files, and will not be shifted during a K(runch. ThEse dangerous 
arsua of your diskette are thus tendered eEfedClvely Ekatmlesap it is 
a good idea to da a bad-blocks scan of each new dlsketCe, at the time 
you first create the fotmaCtedi zeroed diskette- Any bad apuEH on the 
diskette which are discovered at that time can be safely and eaally 
marked* saving you much trouble In Che future* 

WARNINC: A block which baa been "fixed" may still contain useLeea 
garbage. The roeBsage MAY BE OK should be translated as "la probably 
physlcflliy ok"- Fixing a block means that the Inforoiatlon stored in 
the block Ifl read Into the computer, is stored again at the same spot 
OD the diskette, and Is then read again- If the sante Information ia 
tesd from the block both tinjes, that spot on the diskette la ptobably 
not physically damaged C^ome kinds of damage cause Inconslatent 
tecordings)- In that event, the message KAY BR OK la given- However, 
li Che two readings are different, the block is declared bad and may 
be Qiatked as such to protect you from using that spot on your 
diskette- 



The most coimion cause of reported bad blocks on a diskette Is actual, 
physical damage or other problem with the diskette's recording 
surface- Dirt, fingerprints, and peanut butter are common culprits. 
An attempt to stote infotmetlon in a bad block may result in the loss 
of that inf Dtmatlon, and may tender the entire file unreadable- To 

guard against this kind of ptoblem, you should always do the 
following: 

1) Handle yout diskettes very carefully, and keep them clean; 

2) Do a B(ad-blocka scan of every diskette at the time yon forioat 
it, when you Z(era its directory to te'^use it, and at any other 
times when you have suspicions about the disketts- 

A less coimion cause of bad blocka is opening the disk, drive door or 

otherwise disturbing the recording ptocess while the systein is trying 
to store information on the diskette in that drive* This will 
sometimes create an error in the data field of a diskette sector- 
Since the diskette itself is not damaged, this kind of error can be 
"fljted" by the XCamine cooiQand* Howevett the Infocmatloa In that 
block may still be Eaulty, 

Occasionally, the addresa field of a diskette sector may be rendered 
unreadable by something you or the syatem doea- Thia problem is 
reported as a bad block by the DCad-blocka coadoand, but It cannot be 
fixed by the X^amlne cooniaod- When you attempt to read or transfer 
Che file containing the damaged address field, the system will report 
I/O OUtOR |C6i - This problem can be corrected b> reformatting the 
diskette (which erases evetythlng oii the diskette, so be sure to save 
tbe undamaged files, fitst)- Or, of course, you can Just Qiatk the bad 
blocks to avoid using them- 
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MISCELLANEOUS COMIVIANDS 



P(refix 

Changes the curtsnt default Prefix volume name to the volume name 
specified- Theri^aftet, until the next time the system is booted, the 
system will supply this Prefix volume name whenever a file 
specification does not include any volume name or number. 

This command requires that you type a volume name or mimber* An 
entire file specification may be entered, but only the volume name or 
number will be used- It is not necessary for the specified volume to 
be on-line (actually in the syatem at the iDOinent)- IE you specify a 
disk VDlume^ eltlier by number or by naiae, the Ptefiit is set to the 
NAH^ of the dlBketCe in that drive. You may specify devices other 
than a disk volume, such as FKlNTtiK: ■ 

Each time the system is booted^ the Prefix volume name is set to Che 
name of the diskette In the boot disk drive (slot 6, drive I" the boot 
or "Root" volume). At any time, you can return the Prefix volume name 
to the boot voluiQe name again by typing an aatecisk ( * ) In response 
to the Prefix prompt* 

To see which volume name is currently see as the default, you may 
respond to the PreElx ptompt by typing a colon ( : ) alone- 

Using Che C{hange command to change the name of the Prefix diskette 
also changes the default Prefix name supplied by the system- 

On a one-drive syatem, being able to aet the default volume name can 
save you much typing, if you are having to switch back and forth 
between two diskettes. One of the diskettes you use most will usually 
be the boot diskette, which can always be specified by * - If the 
Prefix la set to the name of the other diskette you use often, you can 
eliminate the volume from all file specifications typed while that 
diskette is in the drive- 
On a two-drive system, you can uae tbe Prefix coimnand to make the 
diskette In disk drive volume Ubi (slot 6, drive 2) the Prefix 
default- This saves typing, because the diskettes In the two drives 
cau then be specified with the sliople names ; and * - 

D(ate 

This la the first coomand you should uae every day; it ranks only 
after brushing your teeth as a necessity- The command tells you uhat 
date the syatem ttunks it is, and allows you to i:orrect any mistaken 
ijqjresaion tlie system cilght liave- 
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Prooipt: DATE SET: <1- -31>-<JAN..DEC>-<D0 
TODAv :s ig-AUG-79 
NfM DATE 7 



99:> 



You mny enter the correct date in the tarmat shown after TODA^ IS , 
For example, If today la the 13th of Nnvenber, 1981, you might type 

Rcapon&e: IS-NOV-Bl 

Aftec preaalng the RETURN key, the new date la dlEplayed, Typing 
only g RF-TUHN does not affeqt the current date. The hyphens are 
(fi^llnlcers tar the day, inonth and year fields, and It la possible to 
affect only one or tvo of these fields- For eKample, the year could 
be changed by typing ^-R0 , the month by typing -SEP , etc The 
entire month-name can be entered, but will be trunEzated to three 
letteta by the Filer- Slash f / > Is also acceptable as a dellcnlter. 

In moat caaea, you will need to type only a single number, which will 
aet the new day. For example, If yesterday vse the I9th of Aufiuat, 
you would aitiply type D?0 and press the RETURN key. This command 
and regponee would change the date to the 20th of Auguat (typina D 
Initiates the date-Betting routine, typing 20 aete the new date, and 
pressing the RETURN key tennlnates yout entry). The day-month-year 
order la inviolate, however- 

This date will be essoclated with any filea aaved during the current 
Bession and will be the date displayed for thoae files when the 
directory la Hated- Thla information can be very uaefuX when you are 
trying to tementber which is your latest verelon of a filei 



Q(uit 

Lea^ea the Filer, returning you to the outemoBt Command level of the 

operating system* Remember to have your boot diskette In the boot 

dtive befote you issue thla corninand. 
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FILER COMMAND SUMMARY 



FILE SPECIFICATION 



fS; or MYDlsKl 



ffSsMYFILK.TEXT 
or 
MYDISK:[«Fn.E.TEltT 

MVF1LE.TEJCT[L3] 



Volume name with 
no filename 

Filename with no 
volume name 



CTRL-K 

suirr-M 



Typical volume apecif Icaclon. See Table M for 
device volume naraea and nunhere. 

Typical file specification. Unlesa otherwise 
noted. Filer coflflQsnda require complete file 
specifications, including the suffix- 
Typical filename with file [alze] specifier* 
Used with M(ake and Krannfer conmanda. 

Specifies the boot diskette volume name- 
Specifies the Prefii volume name. 

Specifies the entire named lilskette. 



Specifies the nanied file on the PreEix volume* 

Wildcard used in specifying a aubaet of fllenanea 
to be acted on. For eitample, BR°XT specifies all 
filenames beginning with BR and cmdlng with XT . 

Same as ■ except Filer requests verification before 
acting on each filename- Example: BB?XT 

In T(ransfec, apcclfiea a destination filename which 

is the same aa the source fllename- 
Separatea any number oC Filer coomand response flelda 

Some cocurianda uae response fields in pairs. 

Produces the left bracket! [ 
Produces the right bracket: 1 



SYSTEM COMMANDS 

CTEIL-A Shows the other ^a-character "page" of the system's 

60-charsccec display, until the next CTBL-A . 

GTRL-Z Display scrolls eight and left to follow the cursor. 

CtRL-S Stops any on-going proceea until the next CTRL-S - 

CTRL-F Flushes program output (doea not send It to the screen 

or printer) until the next CTHL-F . 
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GENERAL FILE-MOVING COMMAND 

Ttraiisfer: TranafetB infocfljrtt ion fram the ffrst Hpeclfied vnlump or 

£lle to Che Eecood specified volume nr ElLe, DestlnaClon file 
UBBfl the largest unuBPd dlskeLLe area or the flrat unased area 
af specified [alze]. Used to jnove gc save diskette fileai copy 
enCire disketCefl, or send files to a printer or other device. 



GENERAL DISKFILE COMMANDS 

Mtake: Cteatea a diskette dittctory entry with the apeclfled f i ienajne 
and Lslzc]' PcoduceB a ^'dummy'* file on the diskette. 

Cthange: Renaraoii the specified diskette or diskette flU to the second 
specified oame. If aecond specif I^^at Ion la a filename, It 
need not Include the volume- 

Efentove: Reiaoves the specified file from a diskette's directory. 

KCtunch: PackE the files on Lhe specified diskette so that unueed 

portions of the diskette are combined into one area at the 
end (or othet specified area). 

a(ero: Renamea and erases the directory of the specified diskette. 



WORKFILE COMMANDS 

Gtet; Dealgnates a specified diskette file as the nest workfile (no 
sufflK needed: -TEXT and -CODE are supplied automatically). 
The nejtt E{dlt, Clomplle or Rtun uill use this file- 

S(ave! Saves all versions of the workflle SYSTEM. WRK under the 

specified filename (do not specify a sufflK! -TEXT and .CODE 
are supplied autorikStlcally) . 

MCaw: Clears the workflle, tHnoving all SVSTEM.WRK fllea from the 
boot diskette- 

W(hac: Tells the name and state {saved or not) of the workflle- 



I INFORMATION COMMANDS 



i3 V(oi™^i Sh«,9 the d.vl«. and dlskEtL^ curr^.tly ta th. syBt.^. by 
vplume niifflber and by vdIuioq nanc- 

a.'. :Z Ldst-dlrectory: Sho-a -hat filM are on the specified diakette. If 
& , j Ldst 1"^=^°^^j_ ^^^^ j^ ,^„, ,„ , ,,c„„d specified flla « devlee. 



r 



68 APPfi mSCAL OPERATING SYSTEM 



Ejxtended-dlrectory-Ust: Shows what files are on specified di^l^^"«> 

I; ;3 ^ with extra Information about the files and unused portions- 

I '3 If desired. Hat Is sent to a second specified file ot device- 
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DISK UPKEEP COMMANDS 



I 



'3 BUd-blocIcflt Tests all 28fl blocks on the specified diskette to see 
[a that Information has been recorded consistently- Any bad 

blocks are reported- Use XUnlne to fix bad blocks. 

;3 X<a«lTie- Attempts to fix the specified diskette blocks, previously 
J !«taffllT.e. ^^^^^^^^ ^^^ ^^ ^^^ B<ad-block« comn^and- Ulo«s you to mark 
blocks that can't be fixed, to prevent using those blocks- 



3 



MISCELLANEOUS COMMANDS 



Ptreflti Chenjies the current default volume name to the volume name 

specified. Response of = showa current Prefix ^luD.e nanie- 

D(ate: Lets yoi specify a new current date for the system- Type one 
■ 3 number to change the day. only- 

I Qtult! Leaves the Filer and returns to the outermost Coornand level- 
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INTRODUCTION 



DISKFILES NEEDED 

The following dlakfllea aliow you to edit prograiiH snd text: 



SYSTEri. EDITOR 
Textflle CO be Edited 



(any diskette, any drive; required) 

(any diskette, any drj e^ QptioDal; 
default 1e boot diskette's uoEkfJLe 
S Y STEM. WRK. TEXT, any drivel 



The Apple Pascal ays 
diskette, and stare 
which difik driVG the 
DD the boct diskette 
tecormiended that you 
editing. 

Id additiODi yau may 
available to the sys 

SYSTEM. COMPILER 



SYSTEM. I INKER 



SYSTEM. LIBRARY 



SYSTEM. AS SEMbLrlH 
650tf. OPCODES 



tEiE will retcleve the Workflle fcom the boot 
the uorkfile onto the boot diskette, no matter 
hoot diskette is Jn- However, since other files 
□luat be found In the boot drive, it Is 
keep your boot diskette In the boot drive vhile 



wish to have aome of the following diakfllee 
tem, if needed for your purpoaes: 



(any diskette, any drive; optional; 
used it yai\ Run or Coinpile your 
text af Cer Editing) 

(any diskette, any drive; nptlonali 
used if any external rouCines mua 
be Linked into your ptogram] (no 
Link needed en Use intrlnaie Unit 

(boot diskette, boot drive; optiona 
used if Run calls the Linker, or 
your program needs Long Integers, 
does file I/O, or USES Units) 

(any dlakette, any drive; nptlunal; 
used if yau AiiBemble your text 
after EdlClng] 



The file SYSTEM. EDITOH is normally found on diskette APPLEI: and also 
on diakenne APPLEtf: . One of those diskettes Js your boot diskette, 
so be aure chat diskette is in one of your disk Jrlvea Cpreferably 
Clie Boot drive/ when you select the E(dit option- 

Ooe-dcive syateiDS boot initially with APPLEL: in the drive. If you 
are Just Editing. Filing, and eKecuting profirams that are already 
Compiled, yon can continue to use APPLEl: aa your boot diskette in a 
one-drive system. If you are developing a program, you will want to 

use the Edit-ftun'-Udlt-Hun cycle, which tequirea the Gondii ler in order 
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to Bun your newly-edited profiram. Since Che file SYSTEM. C:OHPILER is 
not on diskette jVPPLEI; , one-drive nsers should put APFLK^: (which 
does contain SYStEM-CUMFlLEH) in thp drive and press Uie KEStT key to 
re-hoot. Thereafter, APPLEtfi is your boot diskette. 

In general, one-drive ueera will follow this procedure when Editing; 

I- if yon will wish to R(un a program you are editing, you raiat 
use APPLEtf: as your boot diskette- With your boot diskette 

(APPLEI: or APPLEI*:) in the drlve» enter the Filer. 

Z, T(r:ansfer onto your boot diskette a copy of the teKtflle you 
wish to Edit. Start the T(rflnBfer with the source diskette 
in the drive, and wait until pcompted hefote putting the 
destination diskette (your boot dlskeltej intn the drive. 

3- With ycur boot diskette in the drive, G(et the tentfile you 
have just T(tansf erred- Then Q(uit the Filer, and enter the 
Editor. The file dealgtiaced by Gfet ia automatically read 
Into the Editor. 

li. Edit the file. q(ult, U(pdate the workfile, and re-enter the 
Editor from time to time. On each re-entry, the updated 
workflie (SYSTEM. WHK, TEXT) la automatlCHlly read hack into the 
Editorn When you are through editing, QCuit and Uipdate the 
vorkClle one last time, but do not re-enter Lhe Editor. 

5- If you are edlnlng n program, you can Rlun the ptoKcam now Co 

clieck "-LB operation and also to generate a code version 

(SYSTOl.WkK.tJUUE) of your latest workflie. Repeat atcps i and 
5 nnti- the program runs as it Rhould. 

ti. Enter the filer and use the S(ave command to rename the 
workflie on the boot dlakette- Then Tfransfer the SCaved 
file or files, one at a time, onto any other diskette. Start 
each Tvransfer with the hoot diskette in the drive, and wpit 
until prompted before putting the destination diskette In the 
drive. 

7. You joay also wish to aCennve the Staved files from yonr boot 
diskette at this time, to leave more roam on that diskette 
for fuLute editing Jobs. 

8. Before you Exit the filer, put your boot diskette back in Che 
drive. 

Two-drive systens also boot with APPLEI: in the boot drtve. If you 
place APPLE!: in the other drive, your aystem can use SYSTEM, COMPILER 
Iroiu that disfcecte when you wanC to H(un a program you are editing. 

Another possibility is to preas RESfJT with APE^LEtf: in the boot drive. 
Uiakette APPLEi*: (which contalnfl liV STEM. COMPILER) then hecoraet: your 
boot diskette tiid you will nut iiave to put APPLEi; In the non-boot 
drive to R.(un a program you are editing. 
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On cwo-drlue ayBtedia, "non-booc drive" iDeana drive volume #5: (che 
"boon drive" la volume (Ji:). On syacoraa uich thrse or more drives 
"non-'booc drive" means any drive encept voliirae ^hi. Systems with ' 
three or more drives cfin leave APPLEi; and APPLEZ: iq drive voluneB 
Si\\ and #5; thtoufihouL the Ed it -Run-Ed It -Run cycle. 

Iq general, Cwo-drlve users will follow this procedure when Editing: 

I* With your boot diskette CAPPLEl: or APPLE0: ) in the boot 

drive, put In Che other drlvt the diskette that has the file 

you wish Co Edit. 



2. 



3- 



4. 



Enter the Flier, and G(bC the tejctfile you trtsh to Edit. 
Then QCult the Filer, and enter the Editor, The file 
designated by G{et Is automatically read Into the Editor- 

Edit the file, q{ult, UCpdatc the workfile, end re-enter 
Editor from time to time. On each re-entry, the updated 
workflle (5YSTEM.URK.TEXT) la autoraaticflUy read hack into 
Editor. When you are through edltine. Qiuit and U(pdate the 
worltflle one last time, hut do not re-enter the Editor. 



the 
Che 



r 






5. 



If you are editing a projiram, you can R(un the pcograia now to 
check its operation and also Co generate a code veralon 
(Sf STEM. HRK. CODE) of your latest vorkfile. If yoar boot 
diskette is APPLEI: , you should put APPLE2: in Che non-boot 
drive before attemptinj; to R(un your program. This ie not 
necesBary if yon are using APPLE0; as your boot diskette- 
Kepeat steps 3 and A until the iirogtam runs aa it should. 

Enter the Filer, and S(ave Che workflle onto a diakette that 
you have put In the non-hoot drive. 



i 



U you are only editing text, you ntay wJah to remove all imneceaaary 
files from a copy of APPLEl : , in order to leave room for larfie text 
files on your boot diskette. The following example shows a directory 
liar of filofl on a possible teKt-edltlnfi-only diskette tianied EDITI: 



EUITI: 










SYSTEM, APPLE 


32 


56-JUL-79 


& 


DATA 


SYSTEM. PASCAL 


36 


4-MAY-79 


2a 


DATA 


SVSTEM.MISCINFO 


I 


4-MAY-?9 


Ik 


DATA 


SYSTEM. EUITOR 


i5 


29-JAN-J9 


75 


CODE 


SYSTEM. FILER 


?8 


2S-HAY-79 


120 


CODE 


< UiJUSED > 


132 




UH 





■ 

i 



When yuu are handling large text files, the amount of unuaed space on 
Che boot diskette 1b important, During the course of editing, the 
file being worked on is uEually stored again and again in the workfile 
□n the hoot diskette. To be safe, the contiguous unused space 
available for storing the workflle should he at least THREE TIMES the 
size of the larj^eat workflle you will store. Since Cext files can be 
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as large as 38 blocks, an unused area of about Hi blocks would he 
HofC' Of course, for working on ameller programs and test much less 
room Is needed . 

Note that test flies always use diskette space In two-block 
IncreiEients . 

One"drive systems must also have room on the boot diskette for the 
original copy of the file being edited. In addition to room needed for 
the workflle* If space is a real problen, you could avoid ll(pdacing 
the workflle by always W(riting to the nairiG of the orlglnsl copy en 
the boot diskette. Instead. That way, the file SYSTEM- WRK. TEXT VnOuld 
not be created. The old veralon of your original copy will be removed 
automatically after each time you W[rite the newest veralon to that 
name- 

Two-drive systems can keep In another drive the original copy of the 
file being ediied, ao that only the workflle SYSTEM -WRK* TEXT appears 
on the hoot diskette In the boot drive* 



A "WINDOW" INTO THE FILE 

The Screen-Oriented Editor ie apeclflcally designed for use with video 
displays ^uch as the Apple's TV or monitor. On entering any file, the 
Editor displays the start of the file on the sei^ond line of the 
screen. If ths file la too long for the screen, only the flrat 
portion is displayed. This Is the concept of a "window". The whole 
file la there and is accessihle hy Editor commands, but only a portion 
of the file can be seen through the "window" of the screen, When any 
Editor coiraiand would take you Co a position In the file which Is not 
dlaplayi^d, the "window" is moved to show that portion of Che tile. 

The Apple Paacal Editor uses a text window that Is ^^ characters wide. 
On the Apple's TV or ncnltor, only the leftpost 40 i^haracters of Che 
window are nomally displayed* to see the rightmost 40 characters of 
the window at any time, juat press CTRL-A- Frequently, the right half 
of the window Is just black, as there Is no text to display there. 
Pressing CTRL-,\ again shifts you back to the leic half of the window. 

You can also cake Che display "acroll" to the right and left, hy 

pressing CTRL-E- In the CTRL-Z mode, the display "followa" the cursor 

everywhere it ^oes. As the cursor movea , the display is automatically 

adjusted to show the text surrounding the cursor. CTRL-Z is cancelled 
by CTRL-A and ]y nany other commands. 

Most programs \Jlll not require you to write beyond the leftmost Al3 
characters. For many otJier text applications, you can adjust the 
display's right icargln to column 39 (see the ECnvttonment command), so 
that the text will be confined to the leftmost ^0 characters of the 
window > 
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THE CURSOR 

The ctitsor marks n paaiclon In the £lle and can be moved to any 
position occupied by cent. The window ahowa a porcion of the file 
near :he duraor. To gee anDthet portion of the file, move the 
cursor. Action usually takes placE In the vicinity □£ the cursor. 

If the text being displayed Is more than A0 characters wide, the 
cursor will disappear when you atove It right, beyond Che leftraoEt i0 
characters. To see the cursor and the text around It, you can press 
CTHL-A fwhlch shows you the other half of the 80-characcer Apple 
Pascal window), or you can invoke the "Auto-follow'^ option by preaslng 
CTRL-Z . After CTRL-Z, the Apple's ^0-characCer display will 
automatically sccoll rlaht and left to follow the cursor wlierever It 
gOEB, so the curaot never disappears from view- CTHL-A and many other 
conmandG cancel the action of CTRL-Z. 

There are a number of commands available to you- Some of the 
coimiands pernilt additions, changes or deletions of such length that 
the screen cannot hold the wtiole portion of the texl that has been 
changed. In those caseu, the screen shows the portion of Che file 
where the cursor ended up after the change. In no case la It 
Decessary for you to operate on pottioiiB of the text not seen on the 
screen, but in some cases it is opticnal- 

THE PROMPT LINE 

The Edltor'a prompt line lets you know, first of all, that you are in 
the Editor rather than In some other part of the system. The Apple 
Pascal operating syateoi Is complex enough that you need these 
aignposts to remember where you are In the system. Secondly, the 
prompt line reminds you of some of the commands you can use. 
Retuembec that on the Apple's Aifl-character screen display, you will 
SDmetimes see only the leftmost i0 characters of the prompt line- Use 
CTKL-A to aee the rest of the line- 
Here iB the complete Editor prompt line- 
>EDIT: A(DJST C(PY D(LETE F<I«D I(HSRT JCHP R(PLACE Q(tlIT Tt(CENG ZCAP 

The letters and numbers in square brackets which will appear on your 
screen at Che end of the prompt line are just the version Eiuniber for 
this portion nf Che program- 

NOTATION 

The notation used 3n this chapter is sometlioes borrowed from Che 
notation used in Che Editor probLpE lines. In the Editor prompt lines, 
a word enclosed between angle-brackets <■ like this > tells you Chat a 
particular key is to be pressed- For example, <RET> means that the 
RETURN key should pressed at Chat point, and <ESC> means to press the 
ESC key. Either lower-case or upper-case characters may be used when 
typing Editor commands- 
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A BRIEF SCENARIO 



This scenario will give yoLt a quick idea of wbat is involved In using 
the Editor, with little or no attempt to explain the terms and 
concepts used- Following the scenario Is a more detailed discussion 
oE the same concepts, in the section called A LItTLE MORE DETAIL. 
Following that section there Is a full discussion of all Editor 
commands ■ 



CLEARING THE WORKFILE 

From Coimi^iid level, with your boot diskette fAPPLE9: or APPLEl:) in 
the boot disk drive {volume tf4:), type F for F(ile > The followinE 
prompt line appears: 

FILER: G(ET, SCAVE, W(HAT, N(EW, L<DIH, R(EM, C(UWG, T(RANS, D(ATE,Q(U1T 

or 

FILER; G, S, N, L, B, C. T. D, Q LC,2] 

Type N for Nfew - If this message appears; 

WORK?rLE CLEARED 

then you can simply type Q to Q(uit the Filer, and proceed Co Che nexc 
section. However, If this message appears: 

THRDi* AWAY CDRRENT WORKFILE ? 

you may be about co lose someone's valuable workflli>. Unless you know 
for sure that ail files beginning with SYSTEM-WRi: on the boot diskette 
are dispensable (these files constitute the workfibi), you should 
teBpond to the above question by typing an N foe "Wo"* Now type S for 
S(ave , and the system will ask you 






SAVE AS WHAT FILE ? 



SAVE AS ? 



Hespond by typing any valid filename (without any .TEXT or -CODE 
sufflxj. For eKRUple, you might type 

The system obediently renaraea SYSTEH.WHK.TEXT as 0LD,WRK-TE>:T , and 
renames SYSTEM, JKK-tUDE tlf there la One) as OLD-vmK-CODE - When chla 
is dane» again type H for B{ew , and this time you wilJ see 

WORKFae CLEARED 

Type IJ for Qfult to return to the system's outemtost Comnand level- 
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STARTING A NEW FILE 

Ucpw Chat the lijorltflle has bKEn cleared, type E for E(dlC fcon the 
Cominaiid level.- Sqdd, thia prompt appears: 

>EDIT: 

NO UDRKFILE IS PEESENT- FILE? ( ^ET> FOfl HO FILE <ESC-RET:> TO EXIT ) 

I 

PreBB the RETURN key to atarL a Tie« file, and thl3 prompt appears! 

>ED:T: AtDJST C(PY D(LETE F(IND I(NSRT J(MP ft{PLACE Q<UIT K(GtlNG Z{AP 

You can now type I ta enter Hnsert aiode, and then proceed to cype 
your prograiD oc teKt, When each portion of Uie insertion la coinplete, 
you press CTHL-C to accept that portion of the Insertion and terminate 
1 insert mode- IE you wlah to add rwre tent, type 1 afiain to re-enter 
Itnsert loode- Further typing will Insert text at the cursor poflftloti, 
until you terminate the latest Jnaertion hy pressing CTRL-C, 

If you wish CO THmove iin«anted text after CTHL-C has terminated an 
Insertion, mnve the cursor to any appropriate part of the text {ufllng 
the arrow-keys), and Chen type U to enter D{eleCe mode, tn D(eleCe 
mode, moving the cursor erases the characters moved over. Terminate 
each deletion by preaalng CTHL-C- 

For example, you mlfcht type I for I insert , and Chen type 

PROGRAM EXAJlPi 
BEGIU 

HRITEC'AN APPLE A DAY') 
END. 

Terminate this insercion by pressing CTHL-C 



UPDATING THE WORKFILE 

Finally, when the text ia the way you uant It for now, type Q for 
<j{ult and then type V for Utpdate. The aystem scores your file in the 
workfUe, a file on the boot diskette called SYSTEM-WRK-TEXT , and you 
are once again at Che outercaost Cjoraiflnd level- 

If your file was a Pascal program (as the example is), you may now 
type H fijr R(un, and the system will automatically atcempc to compile 
and run tlie workfJle, staring the complied version of your program (if 
compilation la successful) as SYSTEM, URK. CODE - If APPLE!: Is your 
boot dlflkecce, APPLES: must he in another drive during compilation- 
Al'PLEi! Is not necessary if APPLET: Is your boot diaketta- 

If you wish to change yonr file £or any reason, simply type E for 
£(dlt again- Nov aworkfile is preuent, and the system automatically 
reads the workfile into the computer, ready foe tnore EdlCln^g- 
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SAVING THE WORKFIL£ 



One-Drive Method 

On one-drive systems, yon can only S(ave one version of the uorkflle 
(usually -TEXTJ onto another diskette. To save more than one workflle 
version (usually -TEXT and .CODE), you must first S(ave all versions 
onCo Che bDot diskette, and then Kransfer each version Co the other 
diskette- Then you can R(emove the Slaved files from the hoot 
diskette- Here is how it might be done: 

When the UCpdated workflle contains your finished produce, or when you 
need to start a new file for anocher project, type F from Corariand 
level to enter the Filer. From Che Filer, type S for S(ave and you 
are pron^ited: 



SAVE AS WHAT FILE 7 



or 



SAVE AS ? 



You should respond by cyping a valid hoot diskette file specification 
iwl Chout any -TIXT or -CODE suffix)- The system Chen renames all 
versions of Che workflle to the filename which you have speclfied- 
For exampLe, IE APPLE0: Is your boot diskette, you might cenpond by 

typing 

APPLEtl: PROGRAM 1 

Tike system obediently renames SYSTEH.URK-TEXT aa PROGRAHl -TEXT, and 

SYSTEM-WHK.CODE (If It eKJsts) aa PROGRAMl -CODE , on the hoot 
dlakette- This step makes the former workflle safe from being 
accidentally erased by a Nieu commsndi and tells the system that Che 
workflle is gone- 



Now type T for T(ranflfer. The eystem proo^jta 



TRANSFER WHAT FILE ? 



TRANSFER ? 



■^-3 



Vou should respond hy typing Che complete file specification 
(Including Che suffix, this tlraej for one version of your saved fllBi 
In the example, you might type 

APPLEtfiPBOGRAMl-TEXT 

When you press [he RETURN key, the system asks 

TO WICRE 7 

Now type the corupleCe file specification for the destination f^le. 
If you wiah to save your PROGRAHl Ellee on diskette HYDISK: , for 
example, yciu wojld type 

MYDISSi PROGRAMl - TEXT 
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The disk drive whlrta, and scan this message appears: 

PUT Ui H¥niSK: 

T¥Pt -tSPACEi TO CONTINL'E 

FqHov the direcclona, putting diskette MYDISK: In the disk dtlve and 
pressing Che Apple's spacebar. When PRQCRAME-TKXT has been 
Bucceasfully transferred to MYDtSK: , ynu nan put APPLE0: back In the 
dlak drive- 
How, repeat the T(rflnafer CDimiiandi Chla time saving the file 
FKDGHAMUCODE £lf it exists) onto HVI>ISK: . When that tranaEer la 
complete, again put APPLE0: back In the diak drive- 

To prevent yonr boot diskette from becoming cluttered up with fllea 
that you have already saved elaewhere, you may wish to remove Che 
PKOGRAMi files frora APPLE0: at this time. Type R for n(eniove> and 
when Che Filer prompts 



t 

i 

V 



REMOVE WHAT FILE 7 



or 



REMOVE 



Cype Che cociplete file apecl f icaClon (including the -TEXT or -CODE 
Buttia) uf one file Lhat you wlsli rtmoved froui Che booC diskecte* For 
eHample, you might respond hy typing 

APPLE0:PR(Jt:RAHi.TEXT 



The Filer soon say9 



APPL E0 : P ROG RAM 1 . TEXT 
UPDATE DERECTOHV 7 



'> REMOVED 



This gives you a iast chance to avoid reinovins the specified file by 
typing an N response- If you type a response of Y , the file 
FRUGRAMl.TEXT Is removed from APPLE0:'s directory, and the system 
forgets that file's exlaCence. You can repeat the R(emDVe coiomand as 
cfcen as yau wish, of couraet uncll all unnecessary files have been 
removed ■ 



Multi-Drive Method 

Cn multiple drive systenst you can 5{ave all the versions of the 
workflle (usually .TEXT and -CODE) directly onto another dlakeCCe, 
using a filename of your choice* Then tJ(ew erases the workflle from 
the boot diskette. This is the process: 

When the lJ(pdated workflle contains your finished product, or when you 
need to start a new file for another project, type F from Coimiand 

level to enter the Filer. From the Filer, type S for S^ave ind you 

are prompted : 



SAVE AS WHAT FILE 7 
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When you respond by typing any valid disk file specification (without 
any ,TEXT or »CCDE sufClxJ, the syatera saves all versions of the 
uortfile under Che f 1 iename which you have specified. For example. If 

you respond by Cyplng 

MY[]1SK:PBDGRAM1 

the system flavta SYSTHH.WBK.TEKT as PROGRAMl .TEXT, and S r STEM. WRK. CODE 
Uf it exists) ae PROGfiAm -CODE , on diskette HYlJISK: 

You can now type the Filer command N(ew , which erases all versions of 
the workflle on the boot diskette, and the creation or editing process 
can begin again. 



RE-EDITING AN OLD FILE 



One-Drive Method 

On one-drive systems, you musc flrsc use Che filer to T(ransfer onCo 
your boot diskette the file you want to edit. Only tlien can vou uao 
the Flier to (J(et that file. 

From Command level, wlEh your hooc dlskente tAPPLE0: or APPLEI:) In 
the dlak drive, type F to enter the Filer. How put into the disk 
drive the diskette concalnirr^ the file you wish to edlc. Type T far 
Tfransfer, and uhen you see the mesHsge 



TRANSFER WHAT FILE 7 



TRANSFER 1 



respond by typing Che complete file specification (Including Che .TEXT 
sufflxj for the textEile you want to edit. For example, to re-edit 
the file saved on MYDISK: in the previous section, you mignC type 

MYDISt:PhOGRAMl . TEXT 

When you press rhe RETURN key, the disk whirrs and this mesaase appears 

TO WHERE ? 

At chis pqJnC you should type the complete file specification (again 
including Che -TEXT suffix) for Che file as Ic will appear on your 
boot dffikette' For example^ If you are using APPLE0: as your boot 
dlskeCCe, you might Cype 

APPLEO:PHUGKAMl.TE]Cr 

After some more disk-whl rrlng, you will be prompted 

PUT O APPLE0: 

TYPE CSPACL^ TO CONTINUE 
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put APPLET: tn the disk driven pre&G Che spacebar^ and a copy of 
PkCGRAMl.TEXT Lb saved on APFLE0: ■ 



Ndv that Che file you waot ro edit is on the hoot dlskeCte^ you can 
type G to G(eL Chat ftle> Uhen you see the prompt 



GET WHAT FILE 7 



GET ? 



type the file specification (vithout the -TEXT L^fflx, thla cine) tor 
the boot dlEketto copy of tho file you want to edit. For the example 
ue have been Bhowing, you wjuld respond to the prompt by typing 

APPLEfl:PROGRAMl 

When the Filer has tleared avay any previous wurkfile (as the conanand 
N(ew did), it narkE tho sp&cilied file as the next workfile- Since 
only the -TEXT version of PKOCRAMl oKiata on APPLET: , you will soon 
bee the oesaage 

TEXT FILE LOADED 

Now type q to Q(uir the Filer, and Eroin Conmand level type E for 
ECdit. The file designated by G(ct la autoinatlcally read Into the 
Editor, ready for work. 



Multi-Drive Method 

On [Qultiple-drlve systSDiSi you can uae the Filer to tifet the file yoa 
uant to edit, directly from any diskette in any available drlve> 

Put your boot dlskeECe (APPLEl: or APPLEB:) In the hoot drive and put 
into another drive the diakette containing the old textfite you wish 
to edit. Frofli Coiomand level, type F to enter Che Filer, and then type 
G for G(ec ■ When you see the prompt 



GET WHAT FILE f 



GET 7 



type the file specif icfltlon for the file you want to edit. For 

ejtample, to re-edit the file saved un MYDISK: In the example earlier 
In this section, you might respond to Che prompt by typln§ 

MYDISK: PROGRAM 1 

When the Flier has cleared away any previous workftle (as the command 

N<ew did), It rriarks Che specified file as the nest uorkflle. Since 

both .TEXT and .CODE versions nf PROGRAM 1 exist on MYDISK: , you will 

soon see the message 

TEXT & CODE FILE LOADED 
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This does not mtan that PROCRAMl has been transferred Co your booC 
diskette or InCo (nemory; you must continue Co leave MYDISK; in its 
drive. Now type £} to Q{uit the Flier, and from Gommand level type E 
for E(dit, The file daalgnaced by G(et Is automatically read into the 
Editor, ready far work. THEN you may take M¥DISK: out of its drive, 
if you wiah- 
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A UnU MORE DETAIL 



j^ I 3 ENTERING THE EDITOR 









When the COMMANB : prompt line ia cm the screen, and your boot diskette 
(usually APPLES! or APPLEl:) la In Che boot drive (volume tfii), type 
an E for Jil^dJt ■ If the systeiTL ^Iresdy has a texc uorkfJle (see 
UOr^FILES, belou)> that file Is auti^imatlcally read Into the Editor, 
ready for work- If the system does not have a workflle yet, or if 
Only a code workflle exists, this prompt line appears on first 
entering the Editor: 



a>EDIT: 
HO WORKFILE IS PRESENT. FILET ( <RET> FOR NO FILE <ESC-RET> TO EJCIT ) 

J Of course* you losy not be able to see the entire prompt line at once- 
3 Uae CTRL-A to flip back and forth between the rightmost 40 characCers 
of Che display and the leEtmost ^0 characters. 

~^ There are three ways to answer this opening prompt line's question; 



1. You can respond by typing the file specification of any Cexcflle 
that already exists on diskette- 

On one-drive systems, you must specify a textfile on the boot 
diskette^ On multi-drive systems, the diskette containing the 
specified file may be in any drive- The Editor vlll read the 
specified file into the computer, and then display the first part of 
Che file's :ejtt on the screen, ready for Editing- 

For example, you might type 

APPLE0:PHaCRAM: 

When you press the RETURN key , the file named PHOCRAM] . TEXT is 
retrieved from diskette WPLE0: and the text of thst file is 
displayed od the screen- 
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2. Vou can answer by preBslng the EETURN key: <R£T> 

Thl6 tells the ayateia that you are atartlng a new file. The only 
thing visible on Che acreen after doing this la the nonnfll EDIT 
pronqiE line: 

>EDn: A(DJST CtPY DCLETE FfIND HNSKT J{MP RfPLACE Q(Un X(CaNG Z(AP 

A now file has been started and currently has oothinB in it. Type 
1 to befiin I(tiaertlng a prograoi or text- No diskette version at 
thig new file eaiets until you q(ull the Editor iind U(pdato the 
workflle or WUiCe to some other disk file- 



3. rou can answer by pressing the ESC key and th-n preBslng the 
RETURN key: <KStJ-RET> 

Thla cflUBCB the Editor to return ynu to the system Comand Ieve\ 
a useful opclun when you didn'c mean to type £ . 



WORKFILES 

The workfile U a diskette "fioratchpad" copy of the file on which you 
are currently working. Each time you qfujt the Editor and Ufpdace 
taee LEAVING THE EOITOR. at the end of this section) » the latest 
version of your progcam ur text is saved in the workflle, under the 
name SYSTEM. WRK. TEXT on the boot diskette. This la a very convenient 
arraagement ■ as you will bee. 

The firec convenience coraea each time you type E to enter the Editor 
from Conmand level. No questions are asked If a workflle already 
eaiSEH (in a file named SYSTEM. WHK. TEXT on the boot diskette). The 
workflle la automatically cead Into the computer and displayed on Che 
screen^ ready for editing. If yau keep the workflle UtpdaCed to the 
latest version of a Job in progress, you can Cum on the computer at 
any time, type E from Command level, and you wi U iooiediaCely be ready 
to work on youf job agiiln. 



Editing using Che workfile ha 
on a program. You can Q(uit 
then Imnediately type R from 
wotkflU automatically. Foil 
coioplled version of the workf 
SYSTEM. WRX, CODE . After che 
executed, Cyping E Ironi Comna 
veralon of your program bac^k 
are altioaC completely spared 
program development. 



3 another advantage when you are working 

the Editor and UCpdate the workflle, and 

Command level to compile and R(un the 

owing a successful compilation, the 

He is auComacically saved as 

code version of your program has been 

od level will aulomaCica lly read the text 

Into the Editor for niore work. Thus you 

Che constant typing of filenames during 



Urdlnfltily, the workfile is created by q£u1tllng Che Editor and 
UtpdatJng the workfile. There Is also one other way to make the 
syetera behave as If there wece a workfile. From che Filer, Che G(eC 



84 APPLE PASCAL OPERATING SYSTEM 



I — 



rra 



i; 3 






command can be used Co designate any CexCflle as the next workflle. 
The file so designated will he read into the computer when you next 
enter che Editor, just as if chat file were on the boot diskette and 
named SY STUM- WRK. TEXT , This designation is "forgotten", however, 
each time you booc che system. 

When you have completed work on your file, you will want to enter the 
Filer and S(ave the latest Utpdaced workflle under some other name, or 
else you will Q(uJE che Editor by Wtrlting to a disk file of some 
other name. Hut during the development of a program or text file, it 
Is very convenient to keep the latest version saved In che workflle. 

To edit a different file when a workfile already exists, the workfile 
must first be cleared, by using the Filer's N<ew conanand (if you wish 
to stare a new file) or the G(et coimnand (If you wish to re-edlt an 
old file). Hake sure that you have Staved the latest version of the 
workflle under inoCher name, before you clear Che workflle, fl all 
versions ol SYSTEM^tfRK Will be erased. 



SOME HIDDEN CHARACTERS 

The Apple II keyboard doesn't appear to have Che left and right bracket 
symbols i and ] . Hut they can by typed- The left bracket is 
produced by typing CTttL-S. The right bracket is produced by typing 
SHIFT-M- You might consider marking these special characters on your 
keyboard- 



MOVING THE CURSOR 

In order to edic, it Is necessary to move che cursor- On the keyboard 
are two "arrow^kcys" which move the cursor right and left. In 
addition to theae cursor-moving keys. CTRL-0 moves tkie cursor up one 
line, and CTBL-L moves the cursor down one line. Some people find Ic 
convealenc Co nark chese last keys with an up-arrow and a down-arrow, 
to help them remember. You can move the cursor only when one of these 
prompt lines is at the top of the screen: EDIT , DELETE , or ADJUST . 

If you type a number before you type a cursor move, the cursor rao^/es 
chat number of characters or lines in the direction indicated. Typing 
P moves the cursor Co the next "page^', a little mora Chan a screenful 
away from the current cursor poaiclon. Also, notice how tlie spacebar 
and the RETURN key move the cursor. Sometimes these moves are useful- 



Vertical mocion of che cursor is made withouc regard to Che text on 

■t J _ M ^l"* P3ge. But for horizontal rmves, the cursor does not like to be 



outside of the text of che program- 
appears after the "H" In "BEGIN" : 



For example, suppose the cursor 
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PROGRAM EXAMP; 

BEGIN 

WklTE("AN APPLE A DA^'J 

END. 
(Actually, the cutaor ie "on" the Invisible RETURN character that ends 
eVEly IJnc.) If you press the right-arrow key, the cursor BKr/ea to 
the "W" in "WRITE" : 

PROGRAM EXAMP; 

B£t;iN 

WKITETAN APPLE A DAY') 
F,ND- 

Sfmllarly, pressing left-arrow key aav moves the cucsnr back to aftet 
the "N" in ''BEGIN", 

if It ia neceaaary to change "WHITE('AN APPLE A DAY')" found in che 
third line to "WRITE£'A« ORAJIGE A DAY')", the cursor mist first be 
JDoved CO the correct spot- 

For example: If che cursor is on the "P" In "PEiOGRAM E>J\MF;", go down 

two lines by presaina CTRL-L twice- After the fJrikt CTRL-L the curgor 

1b on the "S" In "HEGlN"; and after the second CTRL-L Che cursor Is In 
front of Che "W" in "WHITE"- 

PROGRAM EXAMP; 
BEGIN 

WRITECAN APPLE A DAY') 
END. 



tiov, uging Che right-arrow key, move until the curaor alts on Che "A' 
Id "APPLE", 
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Nate that with downward and upward cursor loovea (using CTRL-L and 
CTKL-U) che curaor may at tlraea appear to be outside the ceKC, In 
Che last Illustration, the cutsot appears to be In Che blank apace 
before the "W" In "URlTt", As lat as the Editor knows, hovevec, Che 
curaor Is actually on Che "U" in "WRITE". So do not he aurprlsed 
Vhen, on first pressing Che right-arrow key, Che tiutsor jumpa Co Che 
"R" III '%fflITE". In ocher worda, when the curaot appears to be outalde 
the text, It is conceptually on Che closest character to Che right or 
left. 

HeneiDber that the Apple's TV screen only shova the leftnost ifl 
characters of the systein's tt^-character-vl de display. When the cursor 
disappears into Che hidden portion of Che Pascal display, you can 
EqIIdu it by preasing CTHL-A . Ei/en easier, yau can initiate 
"Auco-follow" mode, by pressing CTRL-Z . After CTRL-Z , Apple's 
ftfl-dhflraccor screen aucomatically sctoLls loft and right to keep the 
cursor visible. CTRL-A and many other coamiandH cancel CTRL-Z - 
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USING KNSERT MODE 

The EDIT pronpC line ahous Che comiand option KnsrC (or "inserc", If 
you like your words wlch all chelr vowels and without parentheses 
running amok inside then). To InaerC an Itera^ first move the cursor 
to the correct position, and then type I . You must always move the 
cursor to the correct position BEFORE typing 1 - Earlier, the curaor 
was aioved to the "A" In "APPLE". Nov, on typing I , an insertion will 
be made just before {just to the left of) the "A"- The rest of the 
line starting with che "A" will be moved to Che riglii^ hand side of the 
screen. If the insertion is lengthy, the right hand portion of the 
Line (beginning with "A") will be moved down to allow room on the 
screen for more Inaerted test Co appear. After typing 1 the follovlng 
prompt line shogld appear on the aereen: 

>INSERT: TEXT [<as> A CHAR,<DEL> A Lt«E] 1<ETX> ACCEPTS, lESO ESCAPES] 

If Chat proitpt line did not appear at Che top of the screen, you are 
NOT in Inserc made. You nay have Cyped a wrong key. 

If che cursor was at the "A" in "APPLE" when you typed I , the Insert 
prompt line appeared and the remaining portion of that line (beginning 
with "A") was pjahed to the right hand edge of the screen- "ORANGE" 
may be Inaerted by typing those six leCCers- They will appear on the 
screen as they sre typed. 

There reoaina one more ImporCant step. The choice at the end of the 
prompc line indicates that <:£TK> (which means pressing tiTRL-CJ accepcs 
Che Insertion, while <ESC> (which oieans pressing the ESC key) rejects 
Che inaerclon so that the teat remains aa it was before typing I - 



(Portion of screen when Inserting ORANCE ) 



PROGRAM EXAMP; 

ilEGIN 

WRITE CAN OR^yffiE 
ENIi. 



APPLE A DAY' I 



B " (Portion of screen after insertion followed by CTRL-C) 

1-1 a 



PROGRAM EXAMP L 
BEGIN 

WRITECAN ORANCEAPPLE A DAY') 



t- ti 
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{Porclon at screen after Insertion followed hy <:ESC> 



PROGRAM EXflJIP; 
BEGIN 

WRITETAN APPLE A DAY' J 
END. 



It IH legal to Insert a carriage teturn. This 1b done hy doing a 
<RET> (that la, pressing the RETURN key) while In the Insert Diode and 
causes the Edltot to start a new line. 



USING D(ELETE MODE 
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The Delete mode works somewhat like the Insert node- Having Inserted 
the word "ORANGE" into the EXAMP prograni and having typed CTRL-C, "AFPLE"^f 
musr now be deleted. Move the cursor ao that It la placed directly on B" 
the fleet characCEr that you wish to delete. Then type D to put the 
Editor Into Delete BBde. The following prompt Ifne should appear. 

>DELETE: < > <HOVrNG COMMANDS> [<ETX> TO DELETE, <ESC> TO ABORT] 

Rpjnerabec that <ETX> means to type CTEtL-C- 

Each time Che rlEht-arrow key la pressed, the charagccr on which the 
CutBor Is Hitting disappears* Pressing the laft-arrow key will erase 
charactecB to the left of the first cursor position. In this esflraple, 
preasing the right-arrow key five times will cauae the word "APPLE" to 
disappear. To ternlnatG the Deletion, you have the samp choice you 
had with Insert. Use <ETX> (by typing CTRL-C) to make the proposed 
deletion periaanenc. Use <ESC> {hy pressing the ESC key) to cancel Che 
proposed deletion and reatore Che original text. 



LEAVING THE EDITOR 

When all the changes and additions have been niade In your program Ot 

text, you will want to exit the Editor and "save" a copy of the 

modified prograra or tent- This la done by typing Q for Q(ulc, which 
will cause this pconpting display: 

>quiT: 

II£PDATE THE WOHKFILE AtlD LEAVE 

EfXIT WITHOUT UPDATING 

R<ETURJJ TO THE HDITOB UlTHODT UPDATRJG 

W(BITE TO A FILE NAME AND RETURTT 
S(AVE WITH SAHE NAME AND RETURN 
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It Is legal to delete a catrlage return. At the end of the line, 

antec Delete morle and preas the right-arrow key until the cursor movea pi 

to the beginning of the neKt line* K 



1 

i 



The most elementary way to save a copy of your present file onto disk 
la to type U for U£pdaCe. This causes your file to be saved In the 
workflle on the boot diskette, under Che flit-name S Y STEM- UHK. TEXT- 
Ulth the workfile thus saved, It Is possible to use the Rfun commandi 
provided of coucse the file la a program. 

It is also possible to use the S{ave option in the filer Cn save the 
diskette wockflle under its own filename before using the Editor to 
modify or create another file- Remember Chat the Filer's N(ew conmiand 
can erase the workflle SYSTEH.WRK-TEXT at any time, and ChaC the 
Editor's U(pdate always stores the just-edited file under the same 
filename SYSTEM.WRK.TEXT. You will not want SYSTEM. UHK-TEICT to be 
your only copy a£ a file, once you are through working on It. 

It is a good Idea to tentporarily Qfult and UCpdate yout file about 
every 15 minutes or so. This way, in case of accident (such aa the 
power soing out, or your mistakenly deleting an Irapotlant part of your 
file), you are rot likely to lose more than 15 minutes worth of typing. 

These are sufficient coamands to edit any file desired* The next 
section describes many more commands in the Editor which make editing 
even easier- 



THE EDITOR COMMANDS 



go General Information 

90 The Cursor 

91 The Scceen 

91 Repeat-factors 

91 The Set Direction 

92 Cursor Mnvea 
92 Moving Ccmmands 

92 Jtump 

93 Ptage 

93 F(lnd 

9^ Sec Direction 

94 Repeet-factot 

94 Ldttrai ur T(oken Searcli 

95 Target String and Delimiters 
95 ESC Option 

95 Same-string Option 

97 Text Changing Coinmands 

97 Knsert 

98 Text Formats 

98 With Afuto-lndent TRUE, Ffililng FALSE 

99 With Afuto-lndent FALSE, F(illlng TRUE 

100 With Afuto-lndent TRUE, FCiillnfi TRUE 

101 With Atuto-lndenC FALSE, FfilUng FALSE 



EDITOR 89 



101 Oislete. 

103 Z(bv 

1D4 C(apy 

IDft From a Diskette F(lle 

105 From the Copy Bfiiffer 

1D7 ]t( change 

LOS R<eplace 

108 Sec Direction 

109 [tepeac-factar 

109 L(lceral or TCaken Search 

109 V(ecify Option 

110 SLringa 

110 String Delimiterfl 

111 Same-strtag Opcion 
113 Formactlng Commands 
113 Atdjufli 

lift MUrgii" 

116 MlacellaneouB CommaDda 

llfi S{eE 

116 MCarker 

118 ECnviiTDnDienC 

119 The EnviiDnnont OpClona: 
119 Afuto-lndenC 

119 FUlllng 

120 LfeEt Margin 
12D R(i£ht Margin 
120 PCaragraph Katg±a 

120 CLDimiiaTid CtiaracLer 

121 Ttoken Default 

122 Vterify 

132 q(uic 

122 D(pdate the Workflle 

122 Efxici without updating 

123 R(eturn ta the Editor 

133 WCrite to any Disk File 
12* S(ave to original Oisk File 

GENERAL INFORMATION 



The Cursor 

The "curaor" is the white rectangle that Indicates yaur position In 
the file. In general, 5p€Ci<Jl "cursor moves" {see below) arc used in 
Che Editor Co DMJve the cur*ior through the text and place it Just where 
you wane the next command to have Its effect- Once you have initiated 
a particular conmiand, the parae cursor moves may have an additional 
function, auch as deleting text or adjusting the position of Lines- 

It fihould be pointed out that not all commands affect the charoccer on which 
the cursor is actually sitting- Some coimnands do affect the character AT 
the cursor position (eXchange, for example, and Delete when used with 
the right-arrow key). But other conimanda affect the fifst cliaracCer to 



r 



the LEFT of the cursor position (for exaaple, Delete when used with the 
lefL'Srrow key). Still other commands affect the place BETWEEN the 
cursor position and the first character to its left (for example, 

^ Inaert). A little experience, or a careful reading of the detailed 
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conuoand descriptiona, will teach you what to expect 



THE SCREEN 

The Apple Pascal system's display Is alvays Sfl characters vide, but the 
Apple screen nornally shows only the 3eftEiiL:jst ii^ characters' If the 
cursor should disappear Into the hidden half of the display, use CTRL-A 
to see the other half of the display. To initiate "Auto-follow" mode. 
In which the Apple screen autooiatically scrolls Left and right to keep 
Che cursor visible, use CTRL-Z . CTHL-A and many other commands cancel 
CTSL-2 , 



Repeat-Factor 



Nost of the Cursor inoveH , and some of the cotunand options, allow 
repeat-factors* A repeat-factor Is a number which is typed 
Immediately before issuing a cursor move or command- The cursor niowe 
or the CDQiDand option is then repeated for the number of times 
indicated by the tepeac-factor* For example, typing 2 followed by 
CTHU-L causes the cursor move to be executed twice, moving the cursor 
down two lines- Cursor moves and commands which allow a repoat-"f actor 
assume the repeat-factor to be I tf no number is typed. Tvplng a 
slash { / } before a cursor move or a comraand Indicates an "infinite" 
repeat-factor, aiid causes the move or cpi^and to be repeated as many 
times as possible in the file. 



The Set Direction 

The first character displayed on most Editor prompt lines ia a 
"direction indlcdtur". On entering the Editor, the set direction Is 
"forward". A "greater than" ( > ) cliaracter indicates "forward" 
direction- A "Uss than" { < } character indicates '^backward" tor 
cGverseJ direction- When the EDIT or the DELETE prompt line is 
showlrtH* you can type the >■ or the c Itoy (with or wJthout thtf SHIFT 
key) to change tie Bet direction. 



Typing one of these keys? 

> + 



Changes the set direction to 
backward 
forward 
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(Certain cajomaDdfi aad certain curaar moveH sre affecCed by Che set 
direction' If Che set dlrecclon la forward, then thoy operate forward 
throuj^h the file, that being the standard directJon of roadlng 
■English- Forward operatianE hogln at the current cursor poaltJoa and 
proceed toward the end of the file- Seckward 3a the reverse 
(iirectlun' backward operations b^gln at the current cursor posjtlon 
and proceed toward the beginning of the file. Where the set direction 
affects a counnand, this ia specifically noted in the detailed coTnmand 
description. 



Cursor Moves 



If you type: 



CTKL-L 
CTRL-0 

rt>(ht-arrDW key 
left -arrow key 

a pace bar 

CTHL-I or TAB key 



RETURN key 
> (eciualsj 



The cursor iDoves: 

down 

up 

right 

left 
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in the set direction ^- 

in the set direction, to Che next tah-stop C 

(tab-stops are set every B spaces 

across the screen) 

In the set direction, to the beginning of H 

the next line B 

to the beginning of the last te>it Inserted, 

Found, or Replaced H 



Repeat-factors can be used with any of the above conmaTids {cKcept the 

"equflla" coQBiand. 

The DdJtor maintains the column pcsitlcm of the cursor wlien you use 
CTHL-O and CTHL-L, even when this rieens that the cursor appears 
Outside the text- If the cursor appears to the t^lj^itt nf a line of 
text, the Editor acta ae thnugh the cursor were lEmnediately after the 
last character in the line. If the cursor appears to the left of a 
line u£ text, the Editor acts as though the cursor were on the first 
character in the Line. 



MOVING COMMANDS 



J(ump 

Jump iiujde la reached by typina J for -I(unp while at the Edit level. 
Dn entering Jump mode the follcwlng proinpt line appears: 

>JUHP: flCEGlNNlSG E(ND H(AKKER <ESC> 
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Typing D for B(e£liming rnoves the cursor to the beginning of the file, 
displays the Edit prompt Line and the first page of the file. Typing 

E for Elnd moves the cursor to the end of the file, displays the Edit 
proiiqjt line and the last page of the file. Typing M for M{arkar 
causes the Editor to display the prompt IJnc: 

JUMP TO WHAT MARKER? 

If you respond bv typing the name of a marker that exists In the file, 
when you press the RETURH key the cursor ia placed at the marker 
position in the text. If you type a marker name that does not exist 
In the tile, this message is given: 

ERROR: NOT THERE- PLEASE PRESS <SPACEBAR> TO COHTINUE. 

and the cursor Is not moved. Placing niEirkers in the text Is explained 
onder 5(et MCarker , In the MlBcellaneoiis Commands. 



PCage 



Pane comoand la oKecuted by typing P while at the Edit level. 
Depending On the Bet direction, Indicated at the beginning of the 

EDIT prompt line, Page coitimand moves the cursor somavhat more than one 
whole Screenful -ip or down* The cursor always oioves to the start q£ 

a line- A repeat-factor ruay be used before this command, for moving 

several pa^es. 



F(ind 

Fine! [Hode la reached by typing F for FMnd while at the Edit level. 
On entering Find mode one of the following prompt lines appears, 
depending on the setting of the Environment's T(DKEN DEFauIt option 
(see Slet E(nvlranment . in Miscellaneous CnnaDands): 

>FlND[l]j L(IT <rAHGET> ■> 
if Che Environment's T(OKEN DEFault option la set to TftllE. or 

>FINDllh T(OK <TAH(iET> -> 

if the EnvironmeriC's T(aKEN DEFault option is set Co FALSE* 

find mode searches through a file in the set direction, finds the 
repeat-factor-th occurrence of the specified string of characters 

*TARGET>, and places the cursor at the end of that string. 
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Set ±lrectioii 

The FUnd command seflrchee for Che specified occurrence iif the Carget 
strliii; beginning at [he ^r^aent cursor position and scanning through 
the tent in Che aet direction (indicated by Che arrov at the beginnlna 
of Che prompt line)' An occurrenci: of the target string ulll be found 
only If it appears In that pnrtlon of the text jhich Ilea betuecn th*- 
cursor and the end of the file cavard which the search is 
progressing- See the section on the set direction (In this chapter. 
Under General InforiDation) in order to change the set direction 
arrow. If t\\v required occurren^^e of Che target string ia nnc found 
by searizhing through the text In th^ set direction, this ioessage 
appears: 

ERHOR! PATTERN NOT IN THE FILE PLEASE PRESS <SPACEBAR> TO CONTINUE, 

Kemcimber, however, Chat che search does not "wrap around", ThaL 
portion of the file between the cursor and the end of the file In the 
direction OPPOSITE che aet direction is not searched. 



Hepeac-'factor 

The repeat-faccor is an Integer froin to 9999 whJcli may be typed Just 
before typing the F for F(lnd- It la shown on the prompt line in 
square brackets: [li r f^^r example- If a repeat- fiac Cor t>f n Is 
specJtled» the cursor is placed after Che n-th occurrence of Che 
Carget string' If no cepeac-factac ia specified, a repeat-factor of 
one Is used- If a repeat-factor of / is used, the cursor Is placed 
after the last occurrence of the specified gtring. 



Lfiteral or Ttoken search 

The target string is treated somewhat differently, depending On 
whether Literal search or Token search Is selecced- The default 
setting a£ Che search mitle is aet in the Ivnvl ronnent . The FIND proiupt 
line Indicaces only the non-default choice: L(1T or T^OK . IE you da 
not specify a search mn'e, the default search racde (the one which ia 
NOT mentianed cm the prompt line) Is used* To use Token search when 
the default is Literal Search (prompt line says T(OK ), type T after 
the prompt line and before the target Bering- To use Literal search 
when Che default is Token search fprompt line says L f IT ), type L 
before typing the target string- Note: nothing appears to happen when 
you typo L or T ; the letter JuaC apriears wlier^ you are about Co type 
the target string. See SCet EdivlronmenC In Miscellaneous Coimnflnds 
for more detail about Literal and Token search modes- In Literal seciri'li 
mode, Che Cdicor will look for ANY occurrence of a string of charactir: 
that eKaccly jnatchee the <TARGET> strint^. In Token pearch mode, the 
Editor will look for ISOLATED occurrences of the <TAR£:ET> string- The 
Editor considers a acriTig isolated If it is surrounded hy any comhlnati on 
of dellihlcecs, where a delimiter Is any character that is not a number 
or Letter- 
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Target string and delimiters 

To allow the target string to [^ontaln any characters [Including RETURN 
characters)* the target string rauet be typed using special rules- In 
particular, Che target scrlng dbibC be set off by characters called 
''delimiters"- Both deliraitera of the target string must he the sauie 
character- One delimiter must precede the first character of the 
string, and the sanie delimiter mist follow the last character of Che 
string. 

'2 The Editor allows any character which ia iwt a letter or a number to 
be a delimiter- This lets you choose the delimiter- The most common 
choice Is the slash 1 / ) because IC Is a lower-case character that fa 
^ not often found In the tes;t. and it la aaay to type- If you forget to 
3 precede the CargeL string With a correct delimiter character* you will 
be told I 

^ ERROR: INVALID DELIMITER- PLEASE PRESS <SPACEBAR> TO CONTINUE. 

Juat try again, this time beginning with a correct delimltec< 



I 

1 
i 



ESC option 

AC any point during your response to the FIND prompt, you can abandon 
this coimnand and return Co the Edit level by pressing the ESC key. 



S(aiiie-Btrlng option 

Typing S Inatead of the delimited target string Cells the Editor to 
use Che same string that was lasc specified for the target string (the 
target string may have heen specified either in Find mode or In 
Replace mode}- From the Editor, typing Clifi conmsnd 



3 

will cause Che cursor to Junp to next occurrence q£ the previously 
specified target string. Whon Che set direction specifies searching 
" 3 through the text in the reverse direction (toward Che beginning of the 
3 flJ.e)| FS may appear to have no cffecC This is because Find mode 

places the cursor Just AITER che found occurrence of the target 
^ string- Unless the cursor Is moved beyond the FIRST character of the 
^ previously found occurrence of the target string, PS will Just keep 
•^ finding the same occurrence of the target string again and agaln- 

Note: The Environment (see S<et E(nvironment , In Miscellaneous 
■ Coranands) displays the current <TARGET> string which will be lovalced 
■^ by typing S as a string ceeponse- 
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EXAMPLE I: 

Suppose you are editing a tile containins the Eollowina cext: 

PHOGKAM STRIHGl; 
BEGIN 

WEITEritXJ WISE ')i 

WEITErVQU ARE'J; 

WRITELN £ ' 1 ' ) ; 
WRITJ^CTUD UISE 'J; 
WRlTELNrVOU BE, 'J 
END. 

In Clie STftlMGl pcoflram, with the cursor at the first P In 
the line 

PgDCRAM STHINGli 

Cype F to select Find modB* When the FIND projopt line appears, Cype 

'WRITE' 

The two single quote marks (or t«o of aonie other dellnlEer) MUST be 
typed- The prciqjt line should now appear as: 

>PIND[IJ: J->tT <TAHGET> ->'WHIT£' 

When you type the last quote mark, the curaar Jiiirips Inmediately to i"lih' 
first ctiaracter following the E in the first accurrence of Lhe Toker. 
target strlnE 

WRITE 
EXAMPLE 2: 

Again In the ST&IMCI program^ with the cursor at the E of ESD. , Cypei 

<2P 

This preparer the flyHtem to Find the second pattern (you typed a 
repeat-foccor of 2) In the reverse direction (you changed the aeC 
direction by typing < )> When the prompt line appears, type 

/WRITELN/ 

The prompt line should redd: 

<FIND[ij! LJIT <TAHGET> ">/WRITELN/ 

When you type the Ifltc / , the cursor will move ImniBdlately to the 
flrfit character following the N in the second occurrence f-iearchlng 
bacilEward through the file) of the token Btrlug WRITELN ■ 



96 APPl£ RftSCAL OPERATING SVSTtM 



EXAMPLE 3; 
First , type 



™ ^ F /WRITE/ 

ri— -^ This locates the first occurrence of the Token string WRITE , 
JJ searching In the set direction. NoH, Cypiog 



wh 



i 3 
t 
i a 



FS 
i^lll make the prompt line flash; 

>FIND[ll: LJII <TARGn> ->B 
and Che cursor will appear at the neitt occurrence of WRITE . 

TE>:r (JHAHGING OiHMANDS 



Knsert 

Insert node Is reached by typlne 1 foe Knsert while at the Edit 
level. Un entering Insert mode the following prompt line appears! 

>INSERTi TEXT [<BS> A CHAR,<DEL> A LINE] i<ETX> ACGEPTS, *:ESC> ESCAPES 

Insert node ollous you to put new information into Che text you are 
creating or editing. The characters Chat you type in this mode are 
insetted between the character on which you placed the cursor and the 
character that vas inoiiediately to Che cursor's left- 

In order to oajilmiae speed, the Editor does not constantly re-write 
Che enCire screen as you inserC each new character. Instead, it makes 
a gap in the test. Just where your insertion will appear, and then 
waits for you to type- UfCen you will have to terminaCe your 
Insertion (by preaalng CTBL-C ) in order to see esacCly how tlie 
laaertion will Look lo Its final foroii 

If you make a mistake while typing In Tr^serc mode, juat use the left- 
arrow key to backspace over your inserted characters- To delete the 
entire line that you are in the process of inserting, back to and 
Including the previous RETURN character, type LTkL-X (some external 
Cerminala use the BUB or ROBOUT key, which generates ASCII DEL). The 
InserC prompt line helps you remenber these mlBCake-correctlng 
possibilities by "i&5> A CHAR" and '*<DEL> A LXNE". <BS> stands for 
the left-arrow (Backspace) key and <T]J^> stands for CTRL-IC . Vou can 
erase only the :ext Chet you have inserted since entering Insert mode- 

The set direction does noC affect the Insert mode- 
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At any time during ao inflortltin, you can cause the Editor to accept 
the InsertloTi as U stands (niak.inB It a part of your file) by presalne 
CTBL-C (which Che prompt J I ne calls *:ETX:. ). Until you pceaa that 
CTRL"C you can cause the Editor to forget everythlna yau ha.e typed 
flincc enCeting Insert inode, by pressing the ESG key- 

If an InserCioD la made and accepted (UBing CTRL-C), chat inaertion is 
also available (until the next insertion or deletion) in the Copy 
buffer, for use by the C(opy command- You can use this to duplicate 
ynur last Insertion as many tiiiiea as you viah. However, if <RSC> ia 
used to reject the insertion, the Copy buffer ia left empty. 

The tttaxlinLiiTi alee of a file Is about 18^00 bytes, or 3B diahette 
blocks- When your file can hold only annther few hundred bytes, you 
ntsy receive thjg warning as you begin Eyping In Insert mode: 



'^ 






EBROR: PLEASE FINISH UP THE INSERTION PLEASE PRESS <SPACEBAR> TO CONTINOE- 



Vhen you respond by pressing the spacebar, you will still be in Insert 
SKide- You can continue your Insertion, but you have bean warned that 
your file ia almost full. You ahould start a new file right away or 
Bpltt the present file Into two parts. Tf you continue typing In 
Insert mode, you will soon receive this more urgent meaaage, risen your 
file has eKccedEid Che SLnount of test it can bold: 

EREOB: BUFFER OVERFLOWMJl PLEASE PRESS tS1'ACEBAR> TO CONTINUE- 

Pressing the spacebar terminates your Insertion, and any further 
attempts to Initiate Insert mode cause this laessage: 

ERROR: NO ROOM TO INSERT. PLEASE PRESS <SPACEaAR> TO CONTINUE. 

Insert mode is imnied lately rerminflted, and you are nat allowed to add 

any more Cenc to your file. 

Teat Formats 

There are two basic ways that t«3(t can be formatced as you Insert it. 
The fonaattlng scheme ia dcterpttnfld by the settings of various options 
In the Environpicnt f sq*! S(eC Ef nvironmcnt , In Mlscellaneoua Coramands). 
AjuCo^indent la uau^lly used for writing Pascal programs, while 
Fdlllng la iDoat often used In writing teat such as letters and other 
documents . 






I 
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Inserting with A(uto-indent TRUE , F(llllng FALSE 

This Is the normal setting of Cho Envlroniuent when you are writing 
Pascal programa* Ouring an Insertion, the margins aet In the 
EnvirDDment are ignored- Instead, you raust terminate each line 
yourself, and start a new line, by pressing the RETURN key. Each new 
line automatically starts at the same indention as the first non-apace 
character o£ the preceding text line. 






-3 
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A new Indentation can be started by typing a apHce (to indent more) or 
by pressing the Jeft-arrow key (to indent loss) or by typing CTftL-Q 
(zero Indentatlm) as the Elrat character of any new line- The A(djust 
command can also be uaed to create a new Indentation for a 



Line. 



IE you use CTRL-G to terminate an Insartion Infnedlately after 
preSBlna tbe RET3RN key (to start a new line), the cursor will 
flutornatically be indented the same amount as the line In which 
you began your Insertion- Thja feature, which can be very useful in 
writing Pascal programH, Ignores any change you oiay have made to the 
indentation of the insertion's first line, and ignores the 
Indentation of Intervening lines. 

A paragraph cannot be formatted with the HCargln command while Autn- 
Indent Is set to True- 



EXAMPLE! 

With the Envifooiiient'a A(uto-indent option aet to TRUE, and the 
Ffllllng option aet to FALSE, enter ICnsart mode and type the 
following sequence of keys (the names of apecial keys are enclosed In 
angle brackets <like thia> >: 

ONE<return> 
<space><space>-iapet;e>TWO<return> 

TRBEE<return> 
<left-arrow>FnUB 

This should create the Indentations shown at Che left below: 



ONE Original indentation 

TWO Indentation changed by <space> <space> <apace> 

THREE <recurn> causes auto-Indentation to level of line above 

FOUR <left-arrow> changes Indentation from level of line above 



Inserting with A(utD-indent FALSE , Ftilling TRUE 

This Is the nornal setting of the F.nvironment when you are writing 
tent such as lettecH and other documents- It is the only Environment 
In which the HCiirgln command will function* The Editor forces all 
Inaertlons Co be between the margins set In the Environment. The 
instant a new wnrd (as you are typing it! exceeds the set R(ight 
margin, a RETUHTJ character Is autamatically inserted before the word 
and the entire word [or as much of it as you have typed at that polntj 
is placed beginning at the set L(eft nargJn- tn the Editor, a "word" 
is any tent character or characters bounded by any two "word 
dellmlterp", where a word delimiter la a apace, a RETURN 
character, the beginning or end of the file, or the beginning or end 
of the current Insertion (before CTRL-C is pressed). The hyphen Is not a 
recognized word delimiter. If two or more RETURN characters are typed In 
iiuccesslDn, the next text is atarted at the set Pfaragreph margin. 
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This setting of the Envlrunment alsn cjiubeb the Editor to adjust the 
margins on the portion of the paragraph follcwlng an insertion (but 
not tbe para§Eflph porcinfi precedlne the Insertion). Tlie Editor 
considers a paragraph to be any text bounded by any two 'Varagraph 
delimiters", where a paragraph deUiifiCer Is a blank line Ccrpatod by 
two RETURN cbaracters), a lino beginning with the Ciammand character 
(set in the EnvlronniEnt ), or the beginning or end of the fUe- 

Note; the autotnatic re-inarglnlns following an Insertion tan sajiietipiea 
cause jou nuich grief. If you are editing in or near a dlagraio, table, 
or other carefully formatted portion of tojit, It ffi a good prei^autlon 
tq tempocarlly set K(llling to False Cjufit type SEfF<apace> )» This 
will prevenl an incidental insertion from refnrmattlng your beautiful 
diagram into a paragraph of meaningless test* 

EXAMPLE: 

With the Fjivlronment's A(utn-lndent option set to FALSE, the FClIllng 
option set to TRUE, the L(efr margin to P, and RflRht margin Co Iff, 
enter I (naert mode and type the following: 

WISU I WEREN'T A WASH-AJ^D-UEAR WAHRIOR 
This should create the text format ahown at the left, belov! 



ei J 



WISH I 

WEREN'T A 

WASH-AND-WEAR 

WARRIOR 



AuCo-returned when next ward wauld exceed margin 
Auto-returned when next word would exceed margin 
Auto-returned at first possible break, even though 
beyond margin. 



InHertlne with Aiuto-indent and FtlHing both TRUE 

With this setting of the Environmant, A^jto-lndent controls Che left 

margin. Ignoring the settings of Che L(e£t margin and ?(aragrflph 
margin. F(llllne Inserts RETURN characters as before, to keep lines 
From ejiceeding the set R<lghc margin- 

However, F(llllng only operates to keep the CURRENT Inaertlnn from 
exceeding the Right margin. Any text on the same line, but to the 
right of the cursor, u^ay extend beyond the Right margin or ouen beyond 
the flfl characters visible on the Apple Pascal eyetem's display- The 
cKlstence of characters beyond pasltlon ?9 Is Indicated by an 
exclamation mark ( ! ) displayed at the rightmost position on the 
screen. To see llie hidden characters. Insert a RETURN character 
anywhere In the visible portion of Che line, or set A{uCo-Indent Co 
False and Mfargln the paragraph. 

Changing the IndenCaClon can be done as before, by typing space, left- 
arrow, or CTRL-q, but only IE that Is Che FIRST character in h new 
line (not likely, since fCilllng will generally begin a line with the 
last typed word)- This aetClng of the Environment is not Ltsually vecy 
useful, as Its effects can be better obtained In other ways- 
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Irxaertlng vlch ACuto-lndent and FCllllng both FALSE 

With ChlB setting of the Environment, the Editor ignores Che [oairgiaa 
^et In the Environment- All laargina, indentations and RETURN 
characters must be typed Jnto the text by you- Characters may be 
inserted at any posiClon on the 5ereen> 

If you attempt to type beyond position 71, the computer may beep to 
warn you. If you attempt to type beyond position 79, an exclaEoatlon 
mark ( 1 } Is displayed at the rightmost position on the screen. Ttils 
character aC Che end of any line indicates that Che line conCains more 
than the 60 characters which can be displayed on the screen* 
Additional characters typed Into that line are not lost, but they are 
not displayed. To see Che hidden characters, yaii can Insert a RETURN 
character anywhere in the visible portion of the line; or you can set 
the Environment's F(llling option Co TRUE, the A£uCo-lndent option to 
FALSE, and then issue the Mfargin command. 



D(elete 

Uelece mode is reached by typing D for ])(elete while aC Che Edit 
level- On encecing Delete isude, the following prompt line appears: 

>DELEIE." < 3 <H0VIWG COHMANDS> [<ETX> TO DELETE, <ESC> TO ABORT] 

In order to delete, the cursor must be Jn the correcC poslclon to 
begin the deletion- If you are going to delete Co Che right (forward 
through Che text), place the cursor directly on Che first characCer to 
be deleted- II you are going Co delete to the left Ebactward through 
Che tekt)^ place the cursor on Che first chaFacter-posltion to the 
right of the first character to be deleted. 

On typing D and entering Delete mode, the Editor remembers where the 
cursor Is- That position Is called the "anchor". Ah the cursor is 
moved away from the anchor in any direction, using Che normal cursor- 
moves, all text becveeo Che cursor and the anchor disappears. When 
Che cursor is ntoved toward Che anchor, che "erased" characters re- 
appear- The repeat-factor may also be used to delete or undelete 
several lines at once, by prefacing a <RET> or any other cursor move 
with a rapeat-faccor while In Delete mode. The slash C / ) repeac- 
facCor cannoC be used. 

To accept the deletion at any point, use <t:rx^. To undo the entire 
deletion at any time before using <CTX>, use <F.SC>. Remember ChaC 
<ETXa rneana Co type CTHL-C and <ESC> means Co press the ESC key. 

Unlike inserting texc, deleting text does ROT cause re-margining of 
Che portion of Che paragraph following che deletion, even If the 
Environment's F(itllng option ±g set to TRUE and Atuto-lndent is set 
CO FALSE. Especially after a deletion that Included a RETURN 
character, cbe line containing Che cursor may excend beyond Che 30- 
characcer Umit d£ Che Apple Pascal syscera'a display. The invisible 
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portJoD of tbe line ia 
laat visible chflracter- 
llne, insert a RETURN c 
line, or use the H(argJ 

All Che text beEwsen [h 
the Copy buffer, ready 
you accept the deletion 
deletion by pressing ch 
want to duplicate aojue 
moving some texC ca ana 
Che text until the move 



indicated by an exclanigt Jon mark M ) in the 

position of Che line- To see the reat of the 
haractec anywhete in Che visible portion of the 
n comoiand to reformat the entire paragraph, 

e curspr and the anchor position is stored fn 
for uae by Che Ciopy conntiflnd, not only aftet 

with CTHL-C , hut also after you reject the 
e ESC key. This last fact Is useful when you 
tExt Jn another locaclon, or ^en you are 
thee location but wish Co keep a backup copy of 

is successfully doinpleted- 



If you attempt Co delete too rnuch text at one Une (the majLiosjiD amount 
varies somewhat^ depending on hov large your file la at the moment. J 
the Copy buffer may be unable to bold all the deleted test, in that 
caae, when you press CTRL-C Co accept Che deletldn this message appears: 

THERE IS KO RQQ« TO COPY THE DELETION. DO VOU WISH TO DELETE ANYWAY? (Y/N) 

If you type V lor '"Yes", the text between the cursor and the anchor 
position is deleted but that teijt Is not placed in the Copy buffer. 
If you type N for "No", the deletion is not carried out, and the text 
in not placed In the Copy buffer. After a responee of either Y or N , 
the Copy buffer is left containing the same text It held before Che 
Utelete command wog initiated- If you reject a deletion that is too 
large fot the ::opy buffer, by pressing the ESC key, no message la 
fiJven at that tine. However, \f you then attempt to C{opy from the 
Copy buffer this message appears: 

ERROR; NO RgOM PLEASE PRESS <SPACEHAa> TO CONTINUE. 
EXAMPLE: 

Suppose you are edltJne the follovlng text: 

PKWJRAM STHlNG2i 
BEGIH 

writec'tdo wise "); 
writelnCto be.') 

END. 

1> Hove Che cursor onto the E in END. 

Z) Type < (This changes the set direction to backward^ 

3) Type D to entet Delete mode, 

A) Preag the HETLTRN key twice. After the first RETURN the line 

WRITKLNfTO BE.') dlsappeara. After the secoad RETURN^ the 

line WHlTEt'TOO WISE'); disappears. 
5) Now presa CTRL-C . The program aftec deletion appears as shown: 

FBOGRAM STRING 2; 
aEGlN 

END. 
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The two deleted lines have been stored In the Copy buffer and the 
cursor has returned to the anchor poEJtion. Nov use the C(opy comiriand 
to copy the two deleted lines at any iilaiie to which the tiursor is 

moved. 

Note: after pressing CTRL-C , if ynu immeidlately C(apy the deletion 
wlthOUT moving Che cursor, the deleted joaterlal is jiiBt replai:ed. 

This gives you one more chance to recover from a mistaken deletion. 



Z(ap 



The Zap comrnnn d is esecnted by typing Z for Z{hp while at the Edit 
level. This coaanaTid deletes all text hetween the current cursor 
position and the start o£ uhat was previously found, replaced or 

Inserted. 

The text position of the first character of the previous Find, 

Replace, ot Insert is called the "equals mark". Typing the = Icey 
will place the cursor exactly at the equali) mark, shouing you where a 
2ap would end. You can then laave the cursor (hut do not use F(lnd] J 
to the beginning of the material you wish to Zap. 

This convnand 1b designed to be iiaed Immediately after one of the Find, 
Replace or Insert cotnnands. If you Insert new material to the right 
of the old teKt that you want deleted, and then move the cursor bacls 
to the beginning of the old test and type Z, you will leave the 
Inserted material t^ile deleting the old text< 

if more than fit) characters .^re being f^apped^ the Editor will ask for 
verlf icatldn: 

warning: VOLI are about to zap MOHF. than m CHARS, 00 VOU WISH TO ZAP? (Y/N) 



Repeat-Eactors and Zap: If a Find or a Replace Is made with & repeat- 
factor, only the last string found or replaced will be deleted hy 
Zap. All. the other Btrlngs will be left as found or replaced' 

All the test that Is deleted by using the Zap carani.ind is placed in th*' 
Copy hufEer, where It is avuHahle foT use with the Tripy Tnode (until 
Che next IriEertlon or deletion)- 

If yon attempt to use Zap to delete too uiuch text at one time (the 
masimuin amount varies sumewhati depending nn how large your file is 
at tlie moment), tlie Copy buffer ma>' be unable to hold all the 
deleted text- In that Cdde, when you type Z Co Zap the deletion, 

first this mesBflge appears! 

WARNllJUi \Oii ARE ABOUT TO ZAP HORE THAI; 80 CHARS, DO YOU WISH TO ZAP? (Y/NJ 

and then, when you type Y for "Yes", this rneaaagi? appears; 

THEHE LS NU ROOH TU CO?Y TlIE DE[.F:TIUP:, UQ YQU WISH TO OELF-Tfi ANVJAV? fV/TJl 
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Tf you type X £or "Vpfi". the tent becuieen the cucaor and cht '^equals" 
pdflitJon is deleted but that text la not placed in the Ctjpy buffer. 
I£ ynii type N far "Nfj'\ the deletion ia not carried out, and the CeicC 
is aot placed In cho Copy buffer. After a responae ot either Y or K 
Che Copy buffer 1b Left containing the Bsme CCKt it held before die 
D(filete coaaaand was initiated- 



C(opy 

Voii get Into Copy made by typina C for Cfopy at any tine the EDIT 
prompt lint! is ahowinfi. On entering Copy mode^ the following oraaiDC 
line is displayed: "^ 



r: 



>COPV: fl<UFFER F^HON FaE <iKSC> 



Cnpying F(roiQ a Diskette File 

To Copy text tliat is atnred in another diskette file, 5o that It ig 
inserted at the current cursor prtsltion in the file you are Editing 
(tliat is, between Cie charai-ter an which the ciiraor si ta and the first 
character to the cursor'a left), type C for Cfopy and then type F for 
F(r(jiQ file ftnd another prnoipr: line appears: 

>COy"i\ FRUri WHAT FILElf'IAHKOiJ'lAIiKEKj ? 

Any ewlgilng disk-ffle file iTiay now he specified- Yog nay type the 
fUenaiGe's -TEXT suffix or ngt, as you wish. The auffi^t -TKXT is 
auCoLDatically supplied if you do not type iC Into yi:iur file 
flpeciflcflLian. To suppress thJa feature (when CJopying from a file whoat' 
natie does nut end In -TKXTl, typs a period followlnE the complete file 
apecificacion. In order no Copy a portion of a file, tVG raarlter^ imjat 
liQve been aet in the text nf tJjal Eije to bracket the desired tesCi The 
markers ciust have been set in the file at an earlier time, when that 
file was tlie file being Editeii (see S(bc Htarker , under HiBcellnneous 
CoPHiidndfi)- 

If your responsG to the prnmpt line above does not include any marker 
names (in equdre hracketa) , the entire specified file is inserted into 
your uorknie- If the file spetlf ication ie followed by tvo raarkur 
names, enclosed in square brackets and separated by a comma, the 
portion of the specified file's text that Is bounded by the two 
markers Is inserted into your workflle. If [ .marker] is used, the 
file la copied fcoio Che boginninfi to Che niarker. If [marker, ] ia 
used, the file is copied frooi the marker to the end of the file* Use 

of Che Copy conmmnd does nut change Che eontents of the file being 
copied from. 
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If your response to the prompt line above does not include any marker 
names (in square brflckets), the entire specified file Is inserted into 
your workflle. If the file apect f Ication is followed by two marker 
names* enclijscd In square brackets and separated by a cfjmiDa, Che 
portion of the specified (lie's text Chat Is hounded hy the Cwo 
markeia Is Insertdd Into your workflle- If [ .marker] Is used, the 
file la copied from the bealnnlng to the marker- If [marker, ] Is 
used, the file Is copied from the market to the end of the file- Use of 
Che Copy command does not change the contents of the file copied from- 

On the completion of the Copy command, after text baa been copied from 
the specified diskette file, the cursor ta placed on the ftiat 
character of Che text which uaa copied and this message appeata: 

BE SURE ORIGINAI, SYSTEM. EDITOR DISK IS IN SAME DRIVE: fR^TORN TO CONTINUE) 

This [QeaBa§e le for one-drive users who have copied ftoni a file on a 
diskette other than their boot diskette- Mien the boot diskette ia 
back In Che boot drive, press [he RETURN to continue. 

If your present file can not contain all the additional text that you 
are attempting to Copy into It (maximum aiie of a file is about 13A00 
hytes, or ^3 diskette blocks), the Editoc copiea in aa much ol the 
additional text aa it can. Then IC glvea thla measage: 

ERROR: BUFFER OVERFLOW. PLEASE PRESS <SFACEBAfi:' TO CONTINUE. 

When you press :he spacebar, Che Copy is complete; your file now contains 
as much of the additional test as the Editor could fit into yout file- 

EXAMPLE: 

Suppose Che diskette named MYDISK; contains a flla named OLDFILE.TEXT, 
which has two markers placed In ita text: ALPHA and BETA - Further 
suppose that yoj are now in the Editor, editing a new file, and you 
ulsh to insert at the current curaor position the text of 
OLDFILE.TEKT bounded hy markets Al-PHA and BETA . 

In response to the EDITOR prompt line, you would first type a C to 
enter Copy mode, and then an F to select copying From-a-f He , This 
prompt line would then appear: 

>COP¥! FROM WHAT FILE [MARKER, MARXER] ? 

To cause the planned Insertion, type 

K¥DISK:OLDFILE{ALmA,BETA] 

Copying from Che Copy BfuEfcr 

Each time text is Inserted or deleted, that text Is also stored In the 
"Copy buffet", sopEtlmeH called the "Insert-delete buffet". To use 
the text in the Copy bufTer, type C to enter C(opy mode and Chen type 
B for Bluffer. The Editor immediately copies the contents of the Copy 
buffer Into the file at the current location of the izursot (that is. 
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between the chafacCcr on which the cursor sits and the Elrst character 
to Che cursor's left). Use of the C(Dpy cnmnfliid does not (Change tht 
contents of thp Copy buffer- 
On Che completion of the C(opy domiaand, after text has been copied 
from the Copy birffer, rhe cursor la pUced on the first character of 
the text whtch wna copied. 

Unlike Inserting text, Copying teict does NOT cause re-margining of 
the portion of the paragraph followinE the Copy, even if the 
Environment's FdllioB option 1b set ta TRUE and Afuto-indent la set 
to FALSE- After Copying, some lines rasy extend heyond the B0- 
character limit of the Apple Fascal. aystem'a display. The invisible 
portion of the line ia Indicated by an endaniatldn mark ( 1 ) in the 
iBBt viBlble chflracter-poaiclon of the Line, To see the rest of the 
line. Insert n RETURN characLer anywhere in the visible portion of the 
line, or use the Mfargln coETjioend to reforinat the entire paragraph. 

The Copy command can be used after an InEcrtlon has beeq made, to 
duplicate the section of te^C just Inserted, as many times as desired. 
Even QKire ccmmion Is to use the Copy conmand ta move text from one 
location in the flic to another. Just Dfelete the text from its 
preaent location, then move the cursor and C(opy the deleted text Into 
Its neu location. 

The contents of the Copy buffer are affected by the following 

coiFLmand&: 

1) D<eleter When you accept a deletion (with CTBL-C), the Copy buffer 
is loaded with the deleted text- When you reject s deletion (by 
presHlnfi the ESC key), the Copy buffer is loaded anyvay, with the text 
that would have been deleted had yaii accepted the deletlon- 

2) I{nstrt: When you accept an insertion (with CTKL-C) , the C^py 
buffer is loaded with the inaerted EtKC. When you reject an Insertion 

tby pteaaing the ESC key], the Copy buffer is entity. 

3) Z(ap? When you delete text using the Zap comiiiflnd, the Copy buffer 
is loaded with the deleted tewt. 

The Copy buffer Is of limited size fthe actual size depends somewhat 
on how much of your computer's memory ia occupied by your uorkflle). 
Whenever the proposed deletion (using either the ;^(ap or the D(elete 
commnd) is greater than the amount of apace available in the Copy 
buffer, the Editor will laaue this warning! 

THERE IS NO ROOM TO COPY THE DELETION. DO YOU WISH TO DELETE ANYWAY? (Y/NJ 

If yoQ respond by typing Y for "Ves", the deletion ia carried out in 
Che normal way, but the deleted text la not stored in Che Copy 
buffer. If you respond by typing N for "No'\ the deletion la 
rejected, but the rejected deletion is not stored In the Copy buffer. 
After either response, the contents of che Copy buffer remain what 
they were before D(eUte or Z(ap was initiated. 
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If you Delete too nuch text and then reject the deletion by pressing 
the £SC key, you are j^lven no ntessage at that time- flnwever^ a 
subsequent attempt to Copy from the Copy buffer causes this rather 
enigmatic message: 

ERROR: NO HOOM PLEASE PRESS <SPACEBAB> TO CONTINUE- 

and the Copy is not carried out- 

If your file is already almost full (uiaxlrDum file sl£e Is about L9900 
bytes, or 42 dlflkette blocks), you may receive one of these messagea 
when you atcempt to C(Qpy from the Copy buffer: 

ERPOB: invalid COPV. PLEASE PRESS <SPACEBAR> TO COHTINUE, 
or 

ERROR: NO ROOM PLEASE PRESS <SPACEBAR> TO CONTINUE, 

In either case, Che Copy is not carried out- Thia condition Indicates 
that It ie time to Etart a new file or to spile yout current file into 
two parta* 



X(change 



The oXchangc ntode Is reached by typing X while at the Edit level- On 
entering eXchaage mode the following prompt line appears: 

>eXCHANGE: TEXT [<BS> A GUAR] [<ESC> ESCAPES; <ETX> ACCEPTS] 

The exchange mode ia uaed to replace the chacacter on which the cursor 
is sitting. Ab you type in eXnhange mode, Che cursor moves tn the 
right along the lino of tent, replacing one character In the line each 
time you press b key- The left-arrow key ( <BS> ) can he used to move 
the cursor back one character, causing the character orlaJnally In 
that position (before the oXchange) to reappear. The set direction 
does not affect eXchange node. 

Aa with many other commands in the Editor, a text eXchange ia made 
final by preaaing CTBL-C ( <ETX> ). Pressing the ESC key ( <ESC> ) 
leaves eXclisnge mode without making any of the changes indicated since 
entering the mode. 

Note: exchange mode does not allow yai to type heyond the end of the 

line, nor does It allow you replace a text character with a RETURN 
character. 

EXAMPLE; 

Suppose you uiah to alter this line of text; 

WRITECTUU WISE ')i 
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After pldclnn tlie cursor on Che W in WISE, type an X to Gntei: eXchangp 
mode* Now type Che letter S and notice how It rt^pIaccB the lettet W . 
Press the left— arrov key to aee the U reappear. Now type S again^ 
Bnd then M » leaving the line of teitt as follova: 

WRlTEt'TOO SMSE " ); 

Typing CTRL-C vill cnake this change final, or preaatng the ESC key will 
cause the original line to he r^talnBd- 



R(eplace 

Heplflce mode la reached hy typing R for B(eplace **ile at the Edit 
level- On entering Replace itiode, one of the following tvo prampt 
lines appears, depending nn the setting of T{OKEN REFault In Che 
Environment faee S<et ECnvlromnent in Hlacel [jineous ComiDands ) : 

>BEPLACE11]: LfH V(FV <TARr.> CSUH> -> 
If the Envlronoient'a T(OKEN DEKagIt Is set Co TRUE, or 

>HEPLACE[1]: TfOK V{FY <TAHC> <snB> => 
If the EnvlromaenC's T(OKEN DEFault is set to FALSE. 

The Replace command searches through a file in the set direction Co 
find reppQt-f ac[or occurrencps of the specified TAHCet scring of 
charactera, and replaces each of those occurrences {aftef 
verification. If that option Is chosen) with the specified SUBstltute 
string of characters. When finished, it places the cursor dt the end 
of the last string found and/or substlcuted- 



r-3 



Set direccloa 

The ^(eplfice command searches for repeat-fact 
target string beginning at the present turgor 
through the text in the set direction findica 
beginning of the prompt line). An occurrence 
will be found nnly if it appears in that port 
lies between the cursor and the end of the fi 
search Is progressing- See Che section nn ch 
chapter, under Geneml Information) in order 
direccion arrow. If die end "1 Che fUe is r 
factor-Ch replacenienC can he carried one, Chl 



or occurrences of Che 
position and scannlne 

Ced by the arrow at the 
of the Cdrget string 

ion of the Cent which 

Is toward vhJch the 

e sec direction fin this 

to change the aet 

eached before the repeat- 

s message appears; 
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ERROR: PATTEHK NOT IN THE FILE PLE^E PRESS <SPACEBAR> TO COSTIWIJE. 

Reraen^er, hok^ever, thac the search does not 'Wap around"- That piirtlon 
of the file between the curRor and the end of the file In Che 
direction OPPOSITE the set direction Is not searched. 
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Repeat-factor 

The repeac-factcr ia an Integer from fl to 9999 which may be typed just 
before Cypln& the R £or R(epl.flce- It Is shown on the pronipt line in 
square brackets: [1] , tor example. If a repeat- factor of n Is 
specified, the next n occurrences of the Carfiet strlna In the set 
direction are replaced. U no repeat-factor ia apecHled, a repeat- 
factor of one l6 used- If a repeat-factor of / le used, all 
occurrences of the target string In the set direction are replaced- 



L(lteral or Tfofcen search 

Ttie target string itt treated somewhat dlffereintly, depending on 
whether Literal search or Token search is selected- The default 
setting of the aearch mode is set In the Environment. The REPLACE 
proiDpt line Indlcfltes only Che non-deEault choice; HIT or T(OK , 
you do not specify a search mode, the default search mode {the one 
which is NOT mentioned on the prompt Line] is used- To nee Token 
search when Che default Is Literal search (prompt line says T{OK ). 
type T after the prompt line and before the target string- To use 
Literal search wlien the default is Token aearch (prompt line says HIT 
>, type !, before typing the target string. Note: nothing appears to 
happen when you t'/pe L or T i the letter just appears where you are 
about Co type the target string. See S(et £(nvlronn.ent in 
Miscellaneous Cotmnands for more details about Literal and Token 
search modes. 



If 



V(erlfy opCioo 

The Verify opCion (shown as V{P¥ on the KEl'LACE prompt line) permits 
esiamlnacion oi each carBet acrlng as ic is found, before che 
replacement Is carried out- You can then decide whether this 
occurrence of Che target string la to be replaced or nnc. To select 

the Verify option in Replace mode, type V before typing the target 
string* Nothing will appear to happen when you type V, hut the Verify 
option will he selected anyway. The following prompt line appears 
whenever Replace mode has found an occurrence of the target string In 
the file and Verify lias been requested; 

>REPLACE: <ESC> ABORTS, 'R' REPLACES, ' 'DOESN'T 

Typing an R. at this poInC will cause Che specified replacement to be 
carried out, while pressing che spacebar will cause the Replace nnjde 
to search for the next occurrence of the target string, provided the 
specified repeac -factor (or the end of the file) has not been reached. 
The repeat-fac:or specifies the number of clraea an occurrence of the 
target string is to be found> not the number of times you actually 
type R CO cause its replacement- Use / as the repeat-factor in order 
CO examine e^ery occurrence of the target string in the aet direction. 
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The Editor has two string storafie varlflbles. The first string 
yarlablG. called <T.'ARt:eT> or cTAKO by the prorapC line, contains the 

target" string, and is used both by the F(lnd coinniand and hy the 
HCtiljlflce command. The target atrJng ia the sequence □£ characters 
which will be searched for by the Find coimnand, or searched for and 
replaced by the Replace command. The second string, uaed only by the 
Replace coramand, Is called <SUD> hy the REPLACE prompt line and ia chi 

substitute string. in the Replace coramand only, the substitute 
string Is the sequence of characters wlijch will replace the target 
string when the target string Is found- 



String deliodters 

To allow the target and substitute strings to contain any characters 
(Including RETURN characters), each string must be typed using special 
rules, in particular, each string must be set off by charactera 
called "dellraltera". Bath dellralCera of a string must he the same 
character, Une delimiter oBist precede the first character of the 
stringi and the saiae delimiter must tollow the laat character of the 
string* 

The Editor allows aljnoat any normal prlnfiag character which Is not a 
letter or a number to he a delimiter- This lets you choose the 
delimiter. The most coomion choice is the slash < / J because it la a 
lower-case character that ia not commonly found in the text, and It 
easy Co type. 

Once you have typed the initial delimiter character for either the 
target or the substitute string, you cannot backspace (usinit; the left- 
arrow key) to erase Chat character or any of the preceding characters 
In your reaponae. If you forget to precede either the target string 
or the substitute string by a correct delimiter character, you will be told. 

ERRUK; INVALID DELIMITER, PLEASE PRESS <SPACEflAR> TO COHTINUE- 

You tflll get the same measage if you try to backspace (by pressing the 
left-:irrou keyj Iinrntid lately after typing the target string's final 
delimiter. Just try the whole command again, and this time use the 
correct dellmltaca. 

Note: many CTRL chflract,?rB have other system uses, and should not be 
used as string delimiters- These include CTHL-A (screen page-flip), 
CTRL-F (stop output), CTRL-H (left-arrow key), CTRL-l Uab), CTRL-M 
(RETURN), CTRL-S (stop program), CTRL-Z (cursor auto-follow), and 
CTRL-@ (hangs system). 
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At any time during your response to the REPLACE prompt, you can 
abandon this coomand and return to the Edit level by pressing the £SC 
key. 

The Same-string option 

Typing S 1(1 the place of the delimited target string tells the Replace 
command to use ths same target string that was last specified. The 
target string iD£y have been specified either by the Find command or by 
a previous use of the Replace cotmEand- Similarly, typing S in the 
place of the delimited substitute string tells the Replace command to 
use the same substitute string that was last specified by a previous 
use of the Replace command. For example, In Replace mode, typing 

S/<flny-strlng>/ 

causes the Replace mode to use the previous target string (and a new 

substitute string), while typing 

/<any-strln8>/S 

causes the previous BubsCltute string to be used (and a new target 
string). Fron the Editor, typing the coranaiid 

RVSS 

says "Do It again'*; it causes the next occurrence of the pcevloualy 
specified target string to be replaced (after verification) with the 
previously specified substitute string. 



Note: tfhea the act direction 
the reverse direction (toward 
appear to have no effect i£ y 
occurrence til the target strl 
places the cursor just AFTER 
string- UolesB the cursor is 
current ly found occurrence of 
occurrence Is changed to a dl 
same occurrence of the target 



specifies searching throngh the text in 

the beginning of the file), RVSS may 
ou chose NOT to replace the last found 
ng- This is because the Replace command 
the found occurrence of the target 
moved beyond the first character of the 
the target string, or unless that 
fferent string, RVSS will just find the 
string again and again* 



Note: The Environment (see S(et E(nvlronment , in Miscellaneous 
CoDEoands) shows you the current cTARGtlT* and *iSUBST:i strings which 
will be invoked by typing S as a string response. 
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EXAMPLE 1: 

Suppose ynu wish to replace the next three accurreaccs of the Cdrgf>c 
string APPLE uJCli the substitute atrlng UAKAMA : 

From EdlC mode, you would type 

3k 

to Indicate a repeat-factor of 3 aad then ro delect the Replace mide. 
In renpcnae to the t^PLACE proiopt line: 

>REPLACE[31: T(OK V(FV <TABC> «UB> => 

yau could type 

/APPLE/ 3 BANANA) 

in this example, flcat the character / Is used as the beginning and 
ending delimiter for the target string, and then Che character ) is 
uaed as the beginning and ending delimltec foe the substitute string. 
In the ej^amplei two different delimiters were used for pedagogical 
puiposes- In practice you would be more likely to use 

/APPLE/ /BAKANA/ 

II you nou wish to Replace 5 more occurrences of the target string 
APPLE I but this time with the aubstltuto string PAPAYA , juaC type 
Cfrom Edit modcj 

5ES /PAPAYA/ 
After g, brief flash of Chla pron^C line 

>REPLACEi5J: T(QK V(FY <TARG> <SU&> ■>S/PAPAYA/ 
the requested rep la cements will be carried out- 
EXAMPLE 2: 
From Edit mode, If you type 

RL/qX//YZ/ 
this pcoDipt line should appear; 

>BEPLACE|l]i L)1T VJFY <TAHC> <SUB> -^L/QX/ZYZ/ 



This command wUl cliange the program line 
VAR SlZE^Xi INTEGES; 



to 



VAU SliEVZilNTEtiKK; 



You must select Che non-default Literal search mode (by typing L 
before typing the target string) because the string 4^^ Is tioC a token 
but is part of t.ie token SIZEijX- 



FORMAniNG COMMANDS 



r'"3 



A(djust 



K 3 Adjust mode is reached by typing A for A(diiJBt while at the Edit 

level. On entering Adjust mode, the following prompt line appears 
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^ADJUST; LJJUST R(JUST C(BNTE& ^LEFT^RlGHT.UP ,DOWN-ABR0WS> [<ETX> TO LEAVE] 

The Adjust mode Is designed to niake it easy to adjuat the Indentation 
of a line or a \.'hDle group of lines. Cursor moves (using the cighc- 
artou and Che laft-arrou keys) can be used to push tlie line right and 
left, or you can adjust Che line Co the L(eft margin, the Ktight 
margin, or the C(enCer. Moving the cursor up or down makes the sacne 
adjustment to lines above or below. Lfae of a repeat-factor is valid 
with all cursor raoves. 

Once you are In Adjust mode, ejch time the right-arrow key Is typed, 
the whole line rvoves one space to the right. The line can be moved 
beyond Che Right riargln set in the Environment. Characters moved 
beyond the aO-tb character position are not displayed^ but their 
exiatence Ih indicated by an exclamation nark M ) In the Sfl-th 
character position of the line. 

Each time the loft-arrow key Is typed, the whole line moves one 
position to the left- file lino can be moved beyond the Left margin 
set In the Environment, hut Che leftmost character cannot be tiioved 
beyond the left edge of the screen display Ubaracter poalclon zero). 

When the line is adjusted to the desired indentation press <ETX> 
(that'a CTRL-C . of course). 



! -. 



Note: <ESC> cannoi: be uaed to Cflncel an Adjustment 

the adjustment, by pressing CTBL-C . 



You HUST accept 
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In arder ta adjust a whole sequence of lines, first adjust the top or 
the bottniD line, Chen (flEFOB^E typine CTRL-CJ use CTRL-0 or CTRL-L 
coLTinanda and the line abijve (oc belowl will automatically he adjusted 
by the same amount when the cursor jumps to that line. Finally, when 
the entire sequence has been adjusted, type CTRL-C- 

Hepeat-facCara, Including / , are valid when used before any of the 
cursor moves while In Adjust mode^ 

Adjust mode can also be used to center text on the page and to left- 
Justify or right-justify text (force all the linea to make a smooth 
left niaEgln» like thle pa^e, or a siDOOCh right margin). Typing L for 
LtJUST while in Adjust mode ciiuneH the line containing the cursor to 
he lef C-juatlfled by moving the leftmost non-space character to the 
Left margin set in the Environment, Similarly, typlna E for B(JUST 
rlght-jusclflea the line by cnoving the rightmost text character to the 
Get Right margin- Typing C fpr C(J£NTEH causes the line to be centered 
between the set Left and KlghC marginsi Typing CTHL-tJ or CTRL-L 
(before :;TRL-C la typed) will cause the line above (or below) to be 
adjuated to the same specification (left-justified, rlght-juatif Jed or 
eenteredj aa the previuualy adjusted line- 



M(argin 



The Margin comnand is executed by typing M for M(argin while at the 
Edit level* There la no Indication of this command In the EDIT prompt 
line- Within the paragraph containing the cursor, Che Margin command 

adjusts the text to compress in as cmch aa possible without violating 
Che three margins set in the Environment- 
Margin iH an Environment dependent command; that ia, it may only be 
executed when FlILLING is set to TRUE and A(UTO INDENT is set to FAISE 
la the Environment. If you attempt to Margin a paragraph when 
ytllling and Afuto Indent are not set correctly In Che Environment, 
this message appears: 

ERROR: INAPPROPRIATE ENVIRONMENT PLEASE PRESS cSPACEHARs TO CONTtSUE. 

You must spt these two optiona correctly In the Environment beEore the 
Margin command can he executed- There are also three parameters (all 
are Set in the Environment) used by this command: R(ICJHT MARCIK, L(EFT 
MARGIN and PCARAgraph MARGIN- See S(et E(nvlrQnment under 
Hisi:ellaneDuB Commands for how to s?C FEllling, A(uto-indent , and the 
margin values- 

The Margin command affects Only the paragraph Which oontalna the 

cursor' A paragraph is defined to be any text bounded above 

and below by any two paragraph dellmitars» where a paragraph deliraiter 

may be a blank line (created by two consecutive RETURN characters) , 
the beginning of the Elle, the end of the flic, or a line which starts 



W APPLE PASCAL OPERATING SVSTm 



B 




w- 


g 


a 


g 


a 


1 


3 


g 


i3 


e^ 


13 


t 


11 


t 


!l 


fe 


^ 


i^ 


^ 


* 


3 


Be 


3 


t. 


^ 


ll 3 



with the Conmand character that is currently set in the Envlronnenti 
LnleHH you change it (see S(et E(nvlronment), the COMHANO CHaracter is 
set by default to the carat ( " )- 

To Margin a parsgraph, move the cursor to anywhere in that paragraph 
and type M . Wlien doing an eifcepciona lly long paragraph, IE may take 
several secnnds before the routine is ready to redisplay the screen. 
When breaking Unes to avoid exceeding the right marglni the Margin 
command recognises all spacea as possible point!! to break the 
line- All Other characters in sequence are considered worda, and will 
not by broken- The Margin CDDraand does not recognize hyphens as 
passible line break points, nor dees it know haw tc correctly 
introduce hypheiis Into words chat do not already contain them- 

Certain characters or character comblnationa, when followed by one or 
more spaces, will be followed hy exactly two space's after a Margin 
command. These charattera include the following: period, question 
mark, colon, ejcclamadion point, ur any of those charattera Immediately 
followed by a cloae-parentheala or double quote- 



EXAMPLE: 

The paragraph beliiw has been Margined with these Envlroanient parameters; 



L(eft margin 
H(jght margin 
Ptaragrapfi nargln 
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Vhen you operate a skateboard in enceaa of 350 miles per hour, 
cerlain problems are encountered. First of all, the number of traffic 
citatLona becomes excessive, unless your akateboacd is equj^sped with 
the proper racicg stripes. Secondly, goggles and knee protectors 
often blow away and skateboards have been known to bi^conie airborne. 
Lastly, you may have to endure the Ire of Parshe and Ferrari drivers, 
since they become depressed, angered, and sometimes say uncQinpllmentary 
things when paseed by a person on a skateboard. 



b ^ 
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Ntxt, Che Bflinc pacagraph 1b shown after being Wflrglned wlch thesE 
parameCCTB set In Che EnvlronnienC : 

L(i?fc margin Ifl 

R<lght margin 6^ 

Pfaragraph lOQrgfn Q 



When you operate a Hkateboard in eitceea of 350 mUee per hour, 
certain probltma are encountered- Flrsc of all, the 
number of traffic cicatiana becnmsE excessive, unlsas 
your skateboard is etjulpped with the proper raclne 
stripes- Secondly, geggJe^^ and knee protectora often 
blow away and skateboards have been known Co become 
airborne- Lastly, you may have Co endure Che ire of 
Porahe and FercarJ drivers, since they become 

depressed, angered, and somi^ClriieB say uncomplimentary 
things when pasaed by a person on a skateboard- 



MISCELLANEOUS COMMANDS 



S(et 

Set mode is reached hy typing S for S(et while at Che Edit level. 
There is no indlcaclon oE Che Set mode option on the EDIT prompc 
line- On entering Che Set cnode, Che following prompt line appcarst 

>SET: E^NVIHONHENT M{ARKER <ESC> 
S(et M(arket: 

When you are editing a i^rge file, It is paccicularly convenlenc to be 
able Cti Jump directly Co certain places In the file by usina markers 
chat have been sec In the desired places- Once set, Jt Is possible 
to jump Co thEse markers at any time, by UHlng Che MUrkej: option in 
the JCuap mode (aee Moving Conmiands), 

The Ctopy F(roiD File command can also make use a£ markers thac have 
been placed in the Cext of a file- When yen are editing one file, Che 
marked portion of a second file that is stored on diskette may he 
copied into the file you ore editing laee Text Changing Comnmnda). 

Tills Is how you plai:e a murkec in the text of a file that you are 
editing- While still In Edit mode, move Che cursor to the spot In Che 
Cent where you want the marker to be placed. When the cursor la In 



116 APPLE R^SCAl Of^RATING SVSTtM 



ii 


Ti 


E 


3 


e 


3 


t 


3 


E 


^ 


■ 


^ 


B 


•3 


E 


^ 


E 


0! 


E 


U 


E 


y 


E 


•j 


fr 


3 


E 


3 


i.3 


fe 


tj 



Che desired spot, Cype S to enter S(eC mode, and Chen type H fac 
Htarker* The following prompc line appears! 

SET MBAT hlARKEH? 

This is sflklng you to Cype the name of the marker which will be placed 
at Che currenc coraor position- The marker name may be up to eighc 
charactera flf /ou type ncre, Chey wlli be truncated to the first 
eighc), terminated by pressing the RETUKN key. Almost any character 
except a carriage return may be used in a marker name, but all lower- 
caae letters are converted to upper-case letters- Note that the Clopy 
F(rom file command uses a comma to separate the two markers which 
specify the cexr to he copied. For use with that command, the first 
marker name uiuat not contain a comina- If a marker with the specified 
nfljfie haa alreed/ been placed in Che text at an earlier time, the old 
marker is moved to the current cursor position without comment, and 
the old position is lost. 

Only ten markers are allowed in a file at any one time- If you 
aCCempt to plac? an eleventh marker, the following message appears: 



MARKER OVFLW. 

) nanie I 

1) na3ie2 



S) naiiiel0 



WHICH DNE TO HEFhACE? 



You must eliminate one of your existing markers before you can place 
the new one. Choose a nnmber from d Ehrougli S, type chat number and 
its place in the list will now he available for your nev marker name- 
Vou can use this nEthod to rename or re-place an existing marker, hut 
you can never elmply remove a marker from your file, even if you 
delete nil the test that contained Che marker. 



(t 



A marker specifies an absolute position in the £ile- If sn inBerCionj 
copy or deletion la made between the beglnnlnE °f the file and the 
marker position, the marker will move along with Che afisoclated cexc 
although the movement Is only approxliaate- 
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E(et EdivlronmenC 

The Fdltpr lets you aet various aspeclB of Lhe editing "errvirDnmeDt" 
Cq HUlC Che taa> at hand- frcmi the Edit level, type S to enter the 
S(et mode, and then type R far ECnvlrunment . The Bcrecn displey is 
replaced with a prompt aimllar Co the one shoun below: 



>ENVTFONMEKTr [nPTlONS] <ETX> OE <SP> TO LEAVF 
AfUTO INDENT TRUF 
yfll.LINC FALSE 

L(EFT f-ARCIK Z 
PCICHT [IA.RG1N 79 
l'(APA MAPGIN 5 

tifnmiAND CH 

TCOKEN DEF TRUR 

7436 BYTES USEP, 12*^20 AVATLAPLE. 



ilTi 



PATTERNS ! 

<TABCET>= 'APPLE', <SUBST>. 



■EAKAtJA' 



HAfiKFHS: 

START 
INTRO 

ACKNOV.T. 



PAHT3 
KAINPAEA 
PART 5 



SQHMARt 
BIBLIOG 

THDEK 



DATE CREATED: 4-13-79 LAST USED: 7-2^-79 



By typing Che appropriate first letter, any or all of the optlona 
listed in the upper portion of the display aay be chanf^ed- The 
sectlnss shown for nany of the options are the default settings for 
the Editor on Dioat screens. Inplementations for some eiCemal 
termlnHls may use different defaults. 

The porllCFn of the display Bhowing the PATTERWS : cTAHGFT? and <SE;BST> 
will not appear iinleas yon have uaed Che FClnd or Rfeplace cmnmands 
since entering thp Editor this Cirae- The portion ol the display 
shoving the HAPKERS: currently In the file vlll not appesr unless you 
have at socie tine ijaed Che S(et Mfarker conmrnnd Co plnoe n morket ±n 
the text. 

The InformBtion stored in the EnvlroflmotiC (with Ihe exception of the 
<TARCET> aitd <SUBST> strini.s) Is aavod each time you eave the file on 
diskette, HP the systoin rnn "remember" that environnent each Cine you 
worlt on that file apain- 
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THE RNVIRONMENT OPTIONS 



Aluto IndenC 



Auco-indent afCecCs only the Editor cumiDands I{naert {under Text 
Changing CocmnHnda) and MCargin (under ForiuatClng Coimnanda)- See the 
dlscuasloos of those oommands for more details and examplea- 

The ACUTO INDENT option la set to TRUE (each new line ia automatically 
started at the same Indentation as the flrat non-apace character of 
the previous Line] by typina A T - 

The A(UTO INDENT option is set Co FALSE (new lines begin at the 
acreea'si left fdge or at Che set Left margin and Paragraph margin) by 
typing A P • Lnleas Auto-Indent Is False (and Filling i& True), the 
Margin oommand will not operate and the Inaert conmand will not cause 
re -Diarg Inning of the portion of a paragraph following an Insertion- 

Auto-Indent should generally be True for writing and editing Paacal 
progcaiBS, and False for vrlting and editlTig natural language cext- 



FdllJnB 

Filling affecCH Che Editor'a iCnsert Conniand (under Tent ChanglTift 
CojnmandsJ and allows the H(argin couiDand (under FomiatClng Commands) 
to function' See che discussions of those commands for rnore details 
aad examplea' 

The F(ILL1NG opclon la set to TRUE (lines are automatically broken 
between words — at spaces and hyphens — to avoid exceeding Che aet 
Right margin) by typing F T . Unlese Filling is Ttue fand AuCo- 
indent Is False), the Margin command will not operate and Che Insett 
comnand will not cause re-marglnning of the portion of a paragraph 
following an Insertion' 

The F(ILLIHG option la set to FALSE (the aet margins are ignored; 
you must end each line yourself] by typing F F - 

Pilling should generally he False for writing or editing Pascal 
prograoia, and True for writing or editing natural language text* 
However, if you are edlclng a table, diagram, or other carefully 
formatted portion of text, it is a very good safety precaution to 
set Filling Co False (from the Edit level, just type SEFF<apace> ). 
This will save you the frustracion of having your text completely 
re-fornacted following an Inaertlon* 
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L(efc iDargln 
R(lght imcgln 
F(aragraph loarglD 

When Filling la True fand Auto-indent is Falae) , the marglna ^et in 
the EnvifonraenC are Che margins which are used by Che tfnserC conmaTid 
(under Text Ghanglne CommandaJ and the M<acgln coraraaod (under 
Focmfltting CoDULandsJ* These Tnarglna alao affect the Center, 
Leit, and Right juatlEylng conimandB in the Adjust inodE {under 
Formatting CDtmiandBj- See the discussions of chose conmands foe more 
details and examples- 

To change the value for Che L{EFT MARGIN option, type L folloved by 
An unslaned integer, and Chen preaa the spacebar. The unsigned 
integer may also be terminated hy pressing Che RETQHH key* The value 
that you type replaces the old value for the Left inargJn In Che prompt 
display shown at the beginning of this section- 

To change the value for Che RtlGHT MARGIN opcion, type H followed by 
an uuBlgned Integer, and then press the spacebar- Kiinllarly, you can 
change the value of the P (AHA MARGIN option by typing P followed by 
an unsigned integer, and then press the spacebar- 

All unsigned integers with four or fewer dlglcs are valid loargin 
values- If you attenqjt to aaEign a maigin value of more than four 
digits, the value will be truncated to the first four digits typed- 
To create normal text displays whose characters ari> all visible on 
Che scrten, you should use margin values fcoin fl through 79, and Che 
Left and Paragraph margin values should he lega than Che value of the 
Right margin. To create text that is confined to the lefC "page" of 
the 4fl-character Apple screen, use margin values from through 39- 



CtoiuiiAnd character 

The CoQDand character affects the M(argla coimnand (under Formatting 
Commands) and re-marg Inning in Che Insert mode (under Text Changing 
CoimDands). See the discussions at chose commands tor more details- 

To change the setting of Che ^(UHMAND CH optlpn, type C followed hy 
alirost any character eacept the RETURN character or ESCape- For 
Example, typing C * wlU change Che set Coimnand character to * . 
This change will be reflected in Che Environment prompt. 

li the Cojimand Charai^ter appears as the first non-blank character in a 
line of Cexc, then Chat line is protected from the Margin coDimsnd, and 
froiQ ce-'marg inning following an Insertion- That line la alga treated 
as a paragraph delimiter for marginning purpoaes. The normal Command 
character la the carat or circumfleit accent ( ' )- Unless you have 
some special use for the carat character In your text, you should 
generally leave It as the set Command character* 
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Kokea default 

This option affects the eearch node ueed by the commands F(ind and 
K(eplar:e (under Text Changing Commands?- See the dlscuasions of 
those commands ^or more details and examples- 

The T(OKEN UEF option is set to TRUE (the default search mode Is Token 
search) by typJrg T I , and to FALSE {the default search Diode ia 
Literal search] by typing T F - 

In Literal search mode, the Editor will Look for AN^ occurrence of 
a string of characters Chat eKactly matches the <TARGET> string. In 
Token search mode, the Editor will look tor ISOLATED occurrences of 
the *a'A[<GET> string- The EdlCor considera a Btring isQlated If It la 
surrounded by any combination of delicnitera, where a delimiter Is any 
character that Is not a number or letter* 

For example, in the sentence "Fue the book In Che baokcaae*", using 
the <TARGi;r> BtrlHg "book", Literal search imde will find two 
occurrences of "book" while Token search made will find only one, the 
word "book" Isalated by the delimiters -cspace* <spBce>. 

In Token search mode you can find an occurrence of the <TARGET> string, 
even if Che occucrence has more spaces or fewer spaces (Including 
aero) corresponding ta each space in Che specified <rAHG£T> string. For 
example, suppose you are searching the fallowing text, which conCfllns 
four allghtly different occurrences of the irards "APPLE FIE": 

I'LL ]]AVE SOME A PFLEPIE, SOME APPLE PIE, 
SOME APFLEPIE, AND THEN SOME AP PLE PIE, TOO- 

If you use the <TAHGET> scring "APPLEPIE" , a Token search will find 
only the third occurrence- With Che <TARGET> string "APPLE PIE" , a 
Token search will find both the second occurrence (which has Tiore 
spaces, but at the right place In Che string) and Che third occurrence 
(which haa fewer spaces, and none in Che wrong place}- With the 
^AHGET> string "A P P L E P t E" , a Token search will find all four 
occurrences - 

Ifowover. only a Literal search would find an occurrence of "APPLE PIE" 
that was buried In the word "CRAKAPPLli: PIH". That's because the "B" 
would not constitute a proper isolating dcllmlter- 

tJhen editJng natural language text, II la a good idea to use Literal 
search mode (set T(OKai DEFault to FALSE). When editing programa, it 
is usually more useful to iiso Taken searct] node (leave T£OKEN DEF set 
Co TRUE )• 
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Vterify 

The Verify caramflnd Is executed by typlnfi V for V(erlfy while at the 
Edit level. There la no indtcaCion of the VCerify coDimflnd oa the EDIT 
prompt liQf The status of the Editor la verified by cedlaplaying the 
screen. The Editor attenipta to adjust the vlndow ao that the cursor 
is at the ccntei of the scteen. ThJs command can be pgychologicaliy 
helpful. Typo it whenever you are unBjjte chat the screen really 
corresponds to what la in your fUe, especialiy when aii Insertion 
leaves an extra word or two dangling beyond the tight end of a line- 
A-'tet typing V the screen Is pretty much guaranleed to accurately 
reflect what is really In your File- 



Q(uit 

Quit DKide la reached by typing Q for q{uit while at the Edit level. 
On entering quit mode, the screen display is replaced hy this 
prompt message: 

>qUtT: 

U(FDATE THE WORKFILE AND LEAVE 
E(XIT WITHOUT UPDATING 

RfETUBN TO THE RUTOR WITHOUT (JPDATrNC 
W(HITE TO A FILE NAME AND HETURN 
SfAVE WITH SAHE NAME AND RETimK 

One of the four displayed options {described beJow in mare detail) 
nuflt be selected hy typing U for U(p<iate, E for Etitit, H for 
Rfeturn, W for Wfrlte, or S for Stave . 



UCpdatB 

This Leila the Editor to erase all pcevlous versions of the boot 
diskette's wotkflle fSYSTEH^WRK-CODE as well aa SYSTEM^WRK TEXT). 
Then Ic afl^;es on the boot diskette, under the filename 
SVSTEM VfflK TEKT, a backup copy of the file currently In jneniocy. An 
TJfpdate should be done at least every 15 minutes, in order to prevent 
accidental loss of your efforrs. From the Editor, every ao often, 
Just type QUE. In a few seconds, the hoot diskette's file 
SYSTEM-URK TEXT will contain the latest version of your warkfile, and 
you win again be In the Editor, ready to continue wodclng on your 
bflcked-up workfile. 



E(xlt 

This causers the system to leave the Editor wlchout saving on diskette 
the file that la currently being worked on In raemory. The hoot 
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dlskecte's backup copy of the workflle, SYSTEM. WRK.TEKT, Is not 
updated to contain the leteat version of the workflle- This nteans 
that any modifications made since entering the Editor are not recorded 
la SYSTEM.WRK.TE>n: or In any other place. All editing wtilch was done 
during the session is irretrievably loat- After eeiectlng this 
option, you are pieced at the Comnand level. 



R(etUTn 

This option lets you return directly to the Editor without updating. 

The cursor la returned to the e>iact place In the file it occupied when 

Q was t/ped- Usually this ccmniflnd is used after unintentionally typing Q 



^ 
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W(rlte 

Selecting this option causes a further prompt to he displayed: 

>qUIT; 

NAME OF OUTPUT FILE <<CR> TO RETOTtN) — > 

The file in Diemory may now be saved under any diskette filename- You do 
not need to Specify the -TEXT suffix; It will be supplied aLiromatlcally. 
If you do not want -TEXT added to the filename, type a period following 
the file specification- In response to the above prompt, you can also 
type your filename, complete with -TEKT suEfla, followed by tile size 
specification' This lets you store your file In a space other than the 
largest unubed area on the diskette. 

If you wish to return directly to editing the file currently in 
memory, without aavtng it, just press the RETUBN key instead of typing 
a filename. If a file with the specified filename already esists on 
the specified diskette, you will be warned- For example, if you try 
to write to HYDLKKiMYFILE, and that file already exists on >rYntSK: 
you will be asked: 

REMOVE OLD MVD1SK;MYFILE.TEXT? 

Type "Y" to continue- After your file has been 
saved on diskette, the Editor displays a message similar to thla: 

>QUIT; 

WRITING 

YOUR FILE IS 197B BYTES LONG- 

DQ YOU WANT TO EfXIT FROM OB R(ETUHN TO THE EDITOR? 

If you type E for EUlt, the system leaves the Editor and returns to 
the Command level. If you type H for R(etiirn, you are again placed 
in the Editor, with the cursor in the same position It occupied in the 
file when q was typed. 
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UlLtia yau dioaBe thla opclon, yaur iitw fliii wl H have Che arnae name as 
tlie file chat was moat recently caJicd By the Cdltor- If the file you 
S(ave was cccaieti aC the current inditing s^ssian and chi^rcfari^ does 
not yet havi? j. name, the file w:HJ he S(aved as SVSTHH.WRK.TEXT . 

Aittr you involte die S(ave option, yuu will he asked H you want to 
putgfc your original file. For example, if yau G(et hTfUISKiHYFILE from 
tbe Fiinr, edit tho file, Q(uit tlie Editor and thtjn SCave Che updated 
Eexti the Eollowlng meesage ulll appear: 

PURGE OLD rmJlSKiMYFILE BEFORE S(AVE? 



t 



It you type '"t" the old fl]e will be roinoved from the dlak beford the 
□eW file is Written out- This may oauae the new file to ouerwrlCe the 
old £ile. If you hdve do backup of the original file and It \5 a large 
file, It would be safer to type "N"- When you type "ti" che old fUe ^ 

will not be averwrittan and only will be removed when the new file la ^1 
successfully written to the disk* If there is not room to copy the new 
file before deatroylitg the old one, the meaaage 



error: wniTiNG out urE file, please press <spacebar> to otntisue 

will appear. Pressing the spacebar will return you Co the Editor. 

Uo nat press RESET after you have given the syEtem permission to 
jlurge your original file; doing so may destroy bath the aid and new 
versions of your file. 

Aftec your file has been saved od diskette, the Editor displays a 
message fiiinilar to this: 

>yLJIT: 

WRITING 

YODK FILE IS I57ii BYTES LONG. 

DO TOU UANT TO ECXIT raoM OR R(ETUaN TO IKE EDITOR? 

If yoti type £ for E[Kit. the system leaves the Editor and reCurns to 
tbe Goninand level. If you type R for R(eturn, you are again placed 

in the Editor, with the cursor In the same position it occupied in the 
file when Q was typed. 
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EDITOR COMMAND SUMMARY 



SCREEN COMMANDS 



CTBL-A 
CTBL-Z 



Shova the other ifl-character "paie" of the display, 
Screen scrolls right and le£t to follow the cursor. 



SPECIAL CHARACTERS 



CTRL'K 
SUIFT-M 



Produces left bracket: I 
Produces right bracket! ] 



CURSOR MOVES 



right-arrow key 
ieft-arros key 

CTRL-0 
CTRL-L 
spacebar 
CTRL- I 

RETUHH key 



Moves repeat-factor apacea right- 

Moves repeat -factor spaces left . 

Moves repeat-facCor lines up- 

Hovea repeat -factor lines down. 

Moves repeat-factor BpaceE In set direction. 

Haves repeaC-f actor tab positions In set direction 

Moves to start of line that Is repeat-factor 

lines awjiy. In set direction, 

Movea to start of latest text found, replaced 

or inserted- 



REPEAT-FACTOR 

An integer from Q 
repeat-factor id 
BE posalble in the 



through 5999 typed before a joove or conmand. If 
/ the mDVe or command is repeated as many times 
file. 



SET DIRECTION 



All change aec dlreetlon to backward 
All change set direction to forward 
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m i ij MOVING COMMANDS 

I J(u[].p: Jumps to file's fl(eglnnlng or Kind, or to previously set Marker, 

K ■ 3 ^^^fe^= f^oves the cursor repeat-factor pages i\^ the set d]re«:tion, 

\ 
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F(lnd: Locks In the set direction fcsr the repeaC-£actor-ch UlCeraL or 

TCoken occurrence of the tTAf4C;t;T> Htrlna* which musi: be typed 
wJth delJmlterB. $ means use Che Game string as before- 

TEXT CHANGING COMMANDS 

l(nBCEt: InsertH text. Use left-artofl key to backspace over insertion- 
CTHL-q deletes hack to the niOHt cecent RETUBN characcer In the 
current InHertloi. CTHL-X acte like CTRL-Q except that It also 
deletes the HETURI4- 
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THE PASCAL COMPILER 



□Celete: Deletes all test moved over by the cursor. 
undeleCe- 



Back up cursor to 



Z(apl Deletes all tej^t between the current curGor position and tbe 
"equals poaltlon^' (at the gtarc of the latest text fnund, 
i-eplaced or inserted)- 

C{opy: Copies a diskette fllE» ai what was last inserted, deleted or 
ZAppedi Into the file at the position of the cursor. 

Xlchange: Replac^sB the character under the cursor vlth the charat^ter 

typed- Each line must be done (separately' Pressing the left- 
arrow key causes the origlDal dharactei: to re-appear- 

R(eplace: LoDka in the set diEectlon for the next L(iteral or T{oken 

occurrence of -iTARO string, and replaces it with CSUH> string- 
Continues rapeat'factor times. E^oth strings icuist be typed with 
dellnl ters- V(erlfy option asks for periDlsslon to replace- S 
Qieans use the same <TAR.G> or the same <SU&> string as before' 

FORMAHING COMMANDS 

ACdJuBt: Adjusts Indentation of the line the cursor is on- Left-arrow 
and rlaht-arrow keys move the line left and right- Moving 
cursor up or down adjusts lines above or below by same amount- 

Mtargln: Starting at Che cursor position, adjusts all text between two ^ 
blank lines (one paragraph) to the ntarglns which have hoen set- ^ 

MISCELLANEOUS COMMANDS 

S(et: Sets a M(arker of the specified narae at the current cursor 

position. Sets opElona In the Elnvlronment for ACuto-lndent . _ 

Fdllingi margins, default search ii;ode, and C(oi]Bnand characters- B |^^ 

VCerlfy: Redisplays the screen with the cursor centered- 

Qjulti Leaves the Editor- You may U(pdate the workflle, E(xlT: without g 
updating, aCetum to Che Gdltor, U(rite to any diskette file, or 
S(ave to your original Elle- 
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INTRODUCTION 



The basic purpose of the Apple Pascal Compiler is Co convert the text 
of B Pascal pragrdm Intci the compressed P-code version of the program. 
This P^code ia Che "machine language" of the PnB[:al paeudo-madilne, or 
"P-machioe", desctlbed In this manual's appendices on the F- 
MACHINE. The P-code version of your program caa Chen he run on 

virtually any computer for which the P-machine interpreter haa been 
ImpleiDented > 



t 



The compiler control options recognized by the Apple Psecal Compiler ^ 

are described In the Apple Pacrcal Language Reference Manual, That V 

foanual alao contalna a list of the error nefiaagee reported by the Apple 
Pascal Compllerp 



Thla chapter ia written apeclflcally for using the Apple Pascal 
operating system with the Apple Pascal progranimlng language and 
the Apple Pascal Compiler. If ycu are using any other programmina 
language, you must first read that language's reference manual for 
special inatructions on using this operating eystem with that language- 

DISKFILES NEEDED 

The following dlslcElles allow you to Invoke the Compiler CKpllcItly: 



i 



Textf lie to he 
Compiled 



SYSTQI' COMPILER 
SYSTEM-LIBflARY 

SYSTEM. ED I TOR 
EYETffl. SYNTAX 



(any diskEttep any drive; default 
la boot diskette's text uorkflle 
SYSTEM. WRK-TKXT. any drive; Pascal 
compiler Si option may also 
specify other source textfUea) 

(any diskette, any drive; required) 

(boot diskette, boot drive; required 
only if program l^SES Intrinsic Unite; 
Pascal compiler SU option may also 
specify other library files) 

[any diskette, any drive; optional; 
to fix errors found by Compiler) 

[boot diskette, any drive; opTlonal 
meBHagea given on entering Editor) 
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In addition to the ahove files, the following files inay he needed if 
^ou are Invoking the Compiler automatically via the Rfiin coiomand: 



E^ ^ 



SYSTEM. LINKER 



SYSTEM. LIBRARY 



iany diaketce, any drive; required if 
external routines need to be linked) 

(boot diskette, any drl^/e; required to 
contain needed eitternal Eoutinea, if 
Linker called) 



1' 

E I 



SYSTEM- PASCAL 



SYSTiW. LIBRARY 



SYSTEM. CHAJISET 



(boot diskette, boot drive; required 
between Compiling, Linking and 
executing atepa) 

tboot diskette, boot drive; required if 
program uses long Integers, does file 
1/0 using real numbers oc SEEK, or 
USES Intrinsic Units) 

(any diskette, any drive; required only 
If progcain uses WCHAR or IffiTRING from 
TIfRTLEGRAPHICS) 
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When you type C for C(anpJle from the Cncnmand level, che file 
SYSTEM. COMPILER must be available on a diskette In any on-line disk 
drive- After c!ie Corapiler reports an error, if you elect to re-enter 
the Editor by typing E foe E£dlt from the Compiler, the file 
SYSTEM, EDITOR nuat be avaHahle in any disk drive. 

On entering the Editor, a meaaage describing your program's error will 
be aJven if the file SYSTEM- SYNTAJt Is available on the boot diskette- 
SYSTEM. SYHTAK is optional; if It is not on Che boot diskette the error 
is reported by number- CoiDpller error messages corresponding to these 
numbers are given In an appendix at the end of the Apple Paacal 
Language Reference Manual- Sone uaera will wish to save foom on their 
boot diskettes by removing the file SYSTEM. SYNTAX, referring to the 
table of oessages In the appendix, instead- 

One-drive note: The files SYSTEM-GOffflLER , SYSTEM-EDITOB , and 
SYSTEM. SYNTAX are all on diskette APPLEtf: , which is the normal one- 
drive boot diskette- If you have been working on a program in the 
Editor, and U(pdating the workflle, your boot diskette 1\as all Che 
files needed to H(un or C(oiLjpile the workflle* If you wish to Rfun 
or C(Dmpile a teKCfile that is not already on the boot diskette, use 
the Filer's T(ranafer command to transfer that textflle onto your 

boot diskette before compiling- If your program requires Linking to 
external routlneH, see this manual's chapter THE LINKER for help- 

Mulci-drive note: The files SYSTEM- EDITOR and SYSTEM- SYNTAX are both 
on diakette APPLEl: , which Is the normal multi-drive boot dlakette- 
The file SYSTEM- COMPILER Is on diskette AP^LE2: . which la normally 
kept in drive volume #5: in a muLtl-drlve ayatem. With AFPLEl; In the 
boot drive and APPLE2: in a non-bnot drive, your system has all the 
files needed to R(un or Cfoiapile the uorkfile. 

Two-drive noce: If you wish to Rfun or CComplle a textflle that is 
not already on APPLEI; or APPLE2: , and your aysteTH has only two 
drives, use the Filer's T{ransfer command to transfer that textflle 
onto either APPLEl: or APPLE2: before compiling. This Ttransfer is 
not necessary en systeniQ with three or more drives* Another 

possibility for t«o-driue systems is to moke APPLES: your hoot 
diskette (just put APPLE(fl: in the hoot drive and press the Apple's 
RESET key)- This frees your second drive to hold a snurce or 
destination diakette for cnrapllations, saving you from T(rflnsf erring 
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Che source file onto APPLEl : or APPLET; - APPLE0: does not contain 
SYSTEM. LiTJKERi If your program requires Llnklna to CKternal routtnea 
use APPLEl: and AFPLE2: - 



If a compllfltlDii iH BO larfie chat the Apple' 
Insufficient, you can use the Filer to Hfgke 
called SYSTEM. SUOPDISK on Che dlakecte conta 
Before any flCCempt to refld a new dlaketce dl 
Include-f lie for example) the syaCEin will fl 
bottom 2K hytea of the data heap In SYSTEM, S 
diskette directory into that ZK area of the 
top-of-Heap memory. When the directory la n 
contents of SVSTEM,SWOPDISK are stored back 

iQCatlODB* 
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B available raeniory Ig 

s four-blocic file 
inlns SYSTEM.COMPILFn*, 
rectory fwhen finding an 
rst temporarily store the 
WOPDISK and then put the 
Heap, Thia saves 3K of 
o longer needed, the 
Into their original Heap 



The Compiler ia invoked hy t/ptng C for Ctorapile or R for R(un from 
the mitermoet Command level of the Apple Pascal operating aysteit. The 
screen imraedtately ahows the message 

COMPILING.., 

The Compiler automatically compiles the boot diskette's wockfilc 
SYSTEM'WBK.TEXT or another workflle designated by the Filer's G{at 
command and saves the reEUltlng code flf compllaClOD ia successful) 
as SYSTI^i.WBK.CODE . If there Is a workflle, but you do not wish to 
compile that file, use the Filer's N(eu command to clear away the 
workflle before compiling. If no workfJLe Is available, you are 
pronptsd for a sjoucce filename- 

COMPILE WHAT TEXT? 

Tou should respond by typing the name of the text file chat you wish 
to have compiled- 



It Is not neceeeary to type Che suffix .TEXT ; chat suffix la 
automatically supplied by the Compiler. If you wish to defeat this 
aufftx-adding feature, to compile a te^tflle »Aose filename does not 
end in -TEXT , type a period { . ) afCer the last character of your 
filename. 

Neitt you will be asked for the name of the file where you wish to ssve 
Che compiled version of your program: 

TO WHAT CODEFILE? 

If you simply press the RETURN key the command will not he terminated, 
aa you might expecC. Instefld, the compiled version of vour program 
Will be saved on Che hoot diskeCte'g workflle SYSTKH-HtK .CODE . This 
ia handy if you Chen wish to Run the program. Pressing cho ESC key in 
response to Chia prompc returns you to Che outermnHt ComoHnand level* 
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If you want che con^lied veraion of your program ta have Che same 
name aa the text version of your program (of course, the suffix will 
be -CODE Instead of .TEXT), juat type a dollar sign ( $ ) and press 
the KETURJJ key. This Is a handy feature, since you will usually want 
to remember only one name for both versions of your program. The 
dollac algn repeats your entire source file speed ficacion. Including 
the volume Identifier, so do HOT specify the diskette before typing 
the dollar sign. Note that this use ie different from the use of the 
dollar sign in the Filer. 

It yoQ want your program stored imder another filename, type the 
desJred f i lename. 

It ia not neceaaary to type the suffix .CODE ; that suffix is 
automntically supplied by the Compiler, If you wish to defeat this 
feature. In order to specify an output filename that does not have a 
,CODE suffix, c.'pe a period £ * ) after the last character of your 
output filename^ Ending your output filename with a file slie 
specification fwith or without a following period) also auppresses the 
addition of the .CODE suffix- The file Is then opened observing the 
given file sJie (on closing, the file will have its actual sire). The 
default file slie for opening this file is [0], See this manual's 
chapter THE FlLEH for details about file size specifications. 

The Compiler then generates P-code codefilcs to run directly on the 
Pascal F-mac:hIae. 

When the Apple la compiling, messages on che screen shov the progress 
of the compIlat:on. The Apple Pascal Language Reference Manual 
describes these messages In detail. 

If the compilation Is successful (that is, no programming errors 

are detected), Lhe Compiler eaves the compiled code under the filename 

SYSTEM. WkK, CODE on the boot diskette, or under another filename 

that you specified earlier* 

The code workfi_e, SYSTEM. WRK, CODE, la automatically erased when any 
text workflle Is Utpdated from the Editor. 

Should the Compiler detect an error in your program, the screen will 
show the text surrounding the error, an error number, and a marker 
««i pointing to the symbol in the aaurce where the error was 
df^tected. For example, you might see Che following message: 

[ «« 

LIKE 9, KRHOH 18: <SP>CCONTimJE) , <ESC> f TERMINATE ) , EfDTT 

Pressing Che epflcehar instrucEs Che Compiler to continue the 
coTiqjilfltion, in case you want to find more of the errors clghc now. 
Pressing the ESC key causes termination of che compilation and return 
to the Caranand Level. Typing E sends you Co che Editor, which 
automatically reada In the workflle, ready for edUing. 
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Aoy etroE whose number is l,^ or Breatec signifies a faCfll error w^ilch 
cauBes ccompllHtioii ta terminate even Jf the Bpacebflr 3a preHEed. 



the wotkflle, chls prompt 



If you were conqjlXina a Cite that was 
appeara when you enter the Editor: 

>EDI3": 

NO WORKFrLE IS PRESENT. FILE? ( <RET> FOB NO FILE <ESC-I1ET> TO EXIT J 

^ou should respond by typing the filename of the £Jle you were 
compJIlng, and that file will then be read into the Editor, Only the 
main prograra Eile will be read into Clie Editor automat icfllly. If your 
program jses Include-f lies, thoee files nuat be read In separately. 
See the Apple Paacal Language Reference Manual for details about the 
Incluile-file compiler nption. 

Uiien Che correct file has been read into the Editor, the Elrst line 
displays the error meaaage (or the error nuoiber. If Che file 
SYSTEM, SyWT AX waa nnt available on the boot diskette) and the cursor ii 
placed at the symbul where the error was detected- 

The error messages corresponding to the erroc numbers reported by the 
Apple Pascal Compiler are given the Apple Pascal Language Reference 
Manual. Some people may wish to save rooni on the boot diskette by 
removing 5YSTEH. SYtJTA^K and uaing the printed taljle nf messaftefl. 
Instead' 

The use of compiler control Qptlona la described In the Apple Paacal 
Lan^ua^e Reference Manual- 
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INTRODUCTION 

Yoti may occDalDnally wish to write amall asBeiohly-lani^uage roucinea 
and tiae then within a Pascal haeC program to provldE low-level or rime- 
critical eacllltles. The Agpeiabler (In cotijimctlon with the Linker) 
meeCB Chis need- Apple Pflfical's 6502 ABsembler la a verflinn of the 
OCSD Adaptable AflHEinbler, apeclfically Implemented for Che 650Z micro- 
proceHBor on ■which the ^ple CorapuCer Is based. 

ThlH HBHenbler was nwdeled after The Last AHsenibler (TLA) developed at 
Che University of Wflterloo. The haalc concept behind both the TLA and 
the UCSD Adaptable ABeembleca 1e the use of a central machine- 
Independent core that la comnran tq all veralons of the asaembler- 
Thls central core U augmented with machlne-apeclf ic code to handle 
Che pecullHritlEH of each Individual machine- 

This chapter Is Intended for a reader vbo la already fluent In at 
leaac one asaembly language- 



DI5KFILES NEEDED 

The following dlHh-fllea allow you to use the Apple Faacal systeiD'H 
6502 ABaembler: 



SYST&].ASSMBl.F;ft 
6500- OPCODES 
6500, ERRORS 



Textfllo to be 
Assembled 



SYSTfW- EDITOR 



Cany diskette, any drive; required) 

(any diskette, any drive; required) 

(any diskette, any drive; optional 

ercnc naasagea given In Aeserabler) 

(any diskette, any drive; default 
l9 boot diskette's wotkflle 
SYSTEM.URK.TEXT, any drive) 

fany diskette, any drlvei optional; 
to fix ertora found by Asaembler) 

S7STH1,ASSMBLER contains the Assembler Itself, and 6500, OPCODES 
contains the op codes for the 65O0 series of mlcroproceasorH tche 
Apple usea a 650?). These files are normally found on diakeCte 
APPLET; . They must be available on any diskette in any of the 
Bystem's dlak drives when you type A Erom Conmand level Co Invoke the 
Assembler- 

6500. ERRORS , nnnnally found on diakette APPLE2: , Is an optional file 
conColnlng the Aaseinbler syntax error meaaaKea. If It la not 
available, the Aasembler will report ayntax errors by number and yoii 
can look up the error deacrlptlcin In Appendix D. Table 6. 

Whao an sssenhly error la detected, you are given the option of 
returning directly to the Editor to correct the problem. If you type 
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r for E(dft from the Asseinblet. the file SYSTEM- EDITOR (normally found 
on your system diskette. APPLE0: or AFFLEl ' ) should be available at 
that time, on any diskette la any disk delve. 

One-drive note- In order to edit and asaerahle a textflle on a one- 
drive syaten, ycu may wlah to use the Filer Co TCranafer the files 
SYSTEM. ASSMBLER and 6500. OPCODES from APPLE2: to APPLEl: , and then 
use APFLEl: as jour boot diakette- Thia leaves 3P blocks unused On 
APPLEli > foe your source Cextflle and workfllea. 

Multi-drive note: With APPLEl: in the boot drive and APPLE2: in drive 
volume *5:, your systeni has all the files needed to Etdit, C(onipile, 
A(G3einble, and Kink prograniE. 

Two-drive note: If you wish to E{dit and Afssenble a textflle that is 
not already on APPLEL: or APPLE?: , and your aystem haa only two 
drives, use the Filer's Tfransfer cOQunsnd to transfer that textEile 
onto eiChel APFLEl: orAPPLEZ: before assembling. 



■® 



B i 



A hidden disk need Is the Assemblec's use of a sioall area (usually leas 
than four blocks) on the boot diskette, in any drive, to store a 
temporary InCemedlate file containing Linker Information* Thia diakette 
file does not norraeUy appear In the diskette's directory, but apace for 
It must he available on the boot diskette. 

An atCenpt Co aflsomble without boot diskette apace for this intermediate 
file (after opening both the output codeflle and the asaemhled listing's 
output cextflle) causes Che moasflge 10 ERROR: NO ROOM ON VOL , after 
which you must press the spacebar to reinitialise the aystem. Your boot 
diskette may then show a new file nflined LIKKER-INFO, of zero length and 
type "infoflle", often between two existing files. You loay remove this 
file or not, as you wish. 

In ordinary use of the Asseinbler, this problem doea not arise, aa the 
file size specif ication [*] is the default used when opening both the 
output codeflle and the aaaembled listing's textflle- This default- 
unusual In the Apple Pascal sys tern— automatically saves room for the 
Assembler's intermediate file. 

However, if the output codeflle exceeds the default file size. Chat file 
is automacicaily extended to maximum [CJ slEe- If Chere was only one 
unused area on the boot diskette, this extension will eliminate the 
space needed b) the temporary file- You can overcome this unlikely 
problem by specifying an apprciprlate file size for the output codeflle, 
or by making sure there are at leaat two non-contiguous unused areas on 
the diskette. 

If an aasembly is so large that the Apple's available iremDry is 
insufficient, /ou can use the Filer to "(ake a four block file called 
SYSTEM -SWAPDISK on the diskette containing SYSTEM .AS-SDIBLEH . Before 
you attempt to read a new diskette directory (when finding an Include- 
file, for example), the systen. will first tenrporaril)f score the bottom 
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USING THE ASSEMBLER 



of- 



Tha A^a^n^blEr is Icwoked by typing A for A(flsen>bla fron the 
m-tar-oat ComrDand level of the Apple Past.l c^er^ting systei^. 
The screen iimnedUtely shows the neflBflHe 



ASSEMBLING,.. 



The Assembler aator^^ tically aH^ej^bles the boc-f: diskette's workflle 
SYSTEM.WiK TEXT cr .nc.her vorkflle de.i,..t.d by the Tller-B lilt 

fcurc'^-flL'^Se:' " "" ""'^'^^ ^^ -.lleble, ycu .re p.o.pted for a 
ASSFHBLH WHAT TEXT? 

iT^tTlLZl'Z". '" '""^ '"' "^ -^ '"^ '»' ^"= ^-" '- "1^1. 

It Is not necessary to type the suffix -TEXT ; chat aufff. Is 
.utocoatlcally supplied hy the Aasemhler, if you don't type It. If you 
"l.h to defeat this suf f l^-addlng feature, to assemble a textflle whLe 
filename d«. not e.d in ,TKXT . type a period ( . ) efter the llsr 
chHCflcter of your filename. 

Next you ^U be .sked for the n«r« of the file «here you «Uh to sav. 
Che asaenbled version of your routine; 

TO WHAT COPEPILE? 

PresBlng ESC in response to this prompt returns you to the outemoaC 
Command level, -^^a l 

If you sltdply press the REITJRN key ths cocnn^and will nt^t he temdnated, 
as you Might expect. Instead, the assemhl.d version of your routine ' 
win be saved on the boot diskette's workflle SYSTEM. WHK. CODE . 

iL^"" "^T ^^^ flsaetibled version of your routine to hsve the same 

brc^n. ^' I ^"'°" °' ^^"^ ""^'"^ <°' ='"'^^^' '^^ =""1'^ "ill 

the'^?L"v':'^' ^M'^f^^-J-r ''^' ' ^'''^' ^^S^ f 5 ) and press 
the RETURN key. This Is a handy feature, since you will usually want 

to renember only cn^ name for both versions of your routine. The 

the Colu^fi^'Mf? '°"' '"''" '^"""'' "^" specification, including 
the volur.e Identifier, so d. NOT specify the diskette before typing 
Che dollflt sign* JK'"e 

:f you want your routine stored under another fUenai^e. type the 
desired flienanie. 
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It Is not necessary Co type the sufflR .CODE ; that suffix is 
automatically supplied by the Asaeiobler. If you wish to defeat this 
suffln-addlng feature, in order to specify an output fllenaite that does 
not have a -CODE suffix, type a period { . ) after the laflt character of 
your Output fllsnanie. 

Ending your output Ellendioe with a file size specif icstion (with or 
without a following period) also suppresses the addition of any 
suffix. The file is then opened observing the given file aiite (on 
closing the file will have its actual size). 



^ 



The usual default file size far opening this file Is (*J . If this 
default sllocfltes insufficient space for your codefile, you may wish 
to specify a different file size* Ending the given filename with a 
period changes the default Elle siae to [0]. If the output codefile 
Is being stored on the boot diskette, and If there Is only one unused 
space on the diskette, this causes the output cndefile Co Initially 
occupy all remaining space on the diskette, leaving no room for the 
required aesernbly-intermedlate file. 

Now that the source and object files for the aesenibly \\Bve been 
specified, Che next prompt line is; 

6500 ASSEMBLER II. B [D.Al 

OUTPUT FILE FOR THE ASSEMHLED LISTING f<CR> FOR NONE): 

You Eoay now specify where you want the Assembler to send the assembled 
listing, or Just press the RETURN key if you do not want this listing, 
(If you wish to abandon the assembly at this point, Just press the ESC 
key.) tf you specify a dlskfile for the assembled listing, you do not 
need to type the .TEXT sufftxj .TEXT will be added for you 
automatically if It is needed. Unlike many parts of the system, 
ending the specified filename with a period does NOT suppress the 
addition of the -TEIQ suffix- Hovever, If the filename you type 
Includes the string .TEXT anywhere in it, the filename Is used 
exactly as typed. If the filename ends In a -TEXT followed by a file 
size specification, Che file is opened observing the given Cite size 
(on closing the file will have its actual sl^ej. The default size for 
opening this file la [*] . 

The assembled tieting Is a detailed display of the progress of the 
assembly showing location numbers, object code, source code, and other 
useful Infomatlon, This listing is independent of the minimal 
assembled object code Chat la saved as the final output of the 
assembly. If an assembled listing is stored as a diskette file, it 
can be sent to the Editor, but non-standard control characters in the 
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file iifllfe it very dlffitmlt Co edit. For InBCancci forni feeds fCTH-Le) 
In the file are Interprered aa clear screen characCETH bv the Editor, 
Type /R/<CTia,>//<FET>/ InmiedlaCely flfcer enterinft the Editor ftjr eaaler 
r^jidlns- See the EXAMPLE Igcer In this chapter for a sample aaHernbled 
listing* 

It you tflah, you can have the aa^BULbled IlBClnp sent to e diskette 
file or to the screen ur printer. As usual for a console or printer 
output, the wordH CONSOLE or PRlNTEH rauac be followed by b colon. I.e. 
CONSOLE: . tf the colon is omitted the listing la sent to a file of 
the name Riven, on the Prefix dtekette- At this point, the proRram 
reports whether or not the output device (if any) la on line- 

The proftram then starts Jiaaemhling the uorkflle. If vou did not tell 
the A^aerabler to send the asseinbled Hatlnfi to CONSOLE: , a simple 
display of the aaaembly's proftreaa appears on the acreen- As assembly 
of your routine continues, the Aasenibler diaplays, on the left-hand 
aide of the screen, one dot for each line of code assembled and a line 
counter every 50 lines* Upon completing each procedure or Cunction, you 
will aee the number of worda of available symbol tdble space In brackets 
and the mesaa^e 

CURREN-r MINIMUM SPACE IS m WORDS 

When En Include-flle la started, the Aaaembler dlaplays on Ihe screen: 

-INCLUDE <fllenaTDe> 

Indicating vhlch file has been Included' If you told the A^&embler to 
aend tho assembled Hatlna Co COWSOLE: , that liatlnp replaces the 
simpler screen diaplay* 

If Che Aaaenbler encounters an error, a mesaaRe shows the offending 
text and indicates the nature of the error. For example, you miRbt aee 

S04 -EQU S 
IDENTtFlEB PREVIOUSLY UECLARED 

The error messaEe will be taken from the file fi^GO-ERKORS if 
poaalble. If tliat la not noaslble, due to space lltnltafions or Che 
absence of the errors file, the error racssfl^E number Is Riven- In 
that case, you mi^hC aee 

S04 ,Eqll S 
ERROR tf 9 
"6500, ERRORS" FILE NOT AROUND 
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A complete Hot of ABBembler aynCex error messsEea correapondlnR to 
these error numbers appears In thle manual'a TABLES appendix- Note 
that the descriptive error raessflfte is Riven at the time the error is 
detected, not on enCerinR tho Editor aa it is done tn the Compller- 
Afcer each error is found, you are Riven the following choice: 

ECDIT,<SPACE>,<ESC> 

This ia almilar to the choice that you are Riven uhen the Compiler 
encounters an error- If you wish to proceed with the BBseTiibly, 
looking for more errors, press Che apacehar. If you Just wish Co 
terminate the aaaembly, returning to the outermost Command levolj 
press Che ESC key. If you type E , the Editor Is loaded into the 
computer, end the workfile ia read into the Editor, ready for 
edicing- If you were assembllnR a file which was not the workfile, 
thia prompt appeara: 

>EDIT: 

NO WORKFILE IS PRESENT. FILE? ( <RET> FOR NO FILE <ESO-RET> TO EXIT ) 

You should now type Che filename of the sourceflle uaed for Che 
aeeeoibly or Che name of the Include-flle If one e>;lBta. That file tflll 
then be read Into the Edltor- 

Uhen the correct file has been read in to the Editor, the flrat line 
diaplaya an error fnessa^e (or an error number If the file 
SYSTfM.SfNTAM is not available on the boot dlekettel and the curaor la 
placed at the point in Che text where Che error was dececced' 



The Editor does not display apGClflc error messages reported by the 
Assembler. Therefore before enCerlnR the Editor from the Asserabltr you 
ahould first note Che specific: error reported by the Aaeembler. 

At the end of a completed aaa^Jmbly* Che Assembler indicates that ic is 
finished and tells you how many errora were found. 

If Che asfiemhly vss succeaaful, the assembled code Is written out to 
the boot diskette's workfile SYSTEM-WRK-CODE or (if no workfile was 
available) to the file that you specified in tho heglnniuR- This code 
file cannot be executed by Itaelf but rauat be used by Linklnfi It in 
with a Pascal host pro^cam file. For information about manual 
Linking, see the EXAMPLE later in this chapter, and also aee thia 
manufll'fl chapter THE LINKER. For information about placing an 
asaepnbled routine into SYSTEM. LIBRARY , aa that RCuo will 
automatically link the correct library routines Into l;he Paacal host 
proaram, Bee this manual'a chapter UTILITY PROGRAMS, 



^ 
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The hoot diskette's code workfile, SYSTEM- WRR. CODE, la automat ically 
eraaed when any text workfile is Ufpdated from the Editor. 
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REFERENCE SYMBOL TABLE 

In the aHBeoibly llatlna, an alphabetic reference ayinboi table 
(SYWBOLTABLE DUMP) 1b generated eqIIdwIiib che assembly of each 
procedtirE ot function, l^ach entry in the reference symbol cable ia 
divided Into three pacta. The first part Is the symbol tdentiEler, 
the aecctid pact Bbows the aynbol type, and the third part shc-wa the 
value fif the syobcl represents an absolute) or the definition 
location (if the ayjnbol represents a label). The definition locattan 
is given as a hlgh-byce first [lumber and corresponds to one of the 
indes numbers In the left-jLost column of the ageembly listing. If the 
symbol represents neither an absolute nor a label, dashes appear in 
the third part of the entry. A vertical bar ( f ) enfia each entry. 
Here Is a reference symbol tabic from the upcooilng eiianiple: 



I ^ 



PAGE - 2 PADDLE 



FlLE:ASMDmo 



SYMBOLTABLE DUMP 



i 

i 



AB - Absolute 
RF - Ref 
PB - Public 

DONE LB 00] F 
LB 0016 



LB - Label 

DP - Def 

PV - PrlvatQ 



UD - Undefined 
PR - Proc 
CS - Const 8 



PADDLE FC 

RETURN AB 



POP 



MC 



MC - Macro 
PC - Punc 



PHEAD? 



The first entry ahovs a LaBel named DONE, defined at location fllJlF. 
The second entry shows [hat PADDLE la the name of the F\inCtlon. The 
last entry shows that RETURN Is an ABaoLute vhich has been assigned 
the value 0000 , Note that the fourth entry 

PHEAD2 LB 0016 | 

Is broken onto tvo different lines. 



EXAMPLE 

This example will show the following: 

U A aample aascnibly-lflnguaBe routine **ich Includes an external 
function (.FUNC), and an eaternal procedure {.PROC>. 

2) The assembled routine, showing the Assembler'a complete 
output listing. 

3} A Paecdl program which calls our assembly -language external 
Tunction and procedure- 

A) Hou to Compile the Pascal program and then Link in Che 

a 6 flembly- language routine. In order to eXecute the program* 



^ 
^ 
^ 
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■ 3 

E ^ 

t 3 

i ^ 



An Assembly-Language Routine 



The following sample an liembly- language routine contains an external 
tunction and an external procedure. The function is the game paddle 
function, and the procedure Is the routine to set or clear one of the 
game TTL outputs. Both are provided for you, completely assembled and 
ready to use, in the UNIT named APPLJ^STUFF (see the Apple Pascal 
Language Reference Manual]* See the later sections of the current 
chapter for detfllle about the Assembler directives -FUNC and .ETIOC • 

The following shows the assembly-lanfiuflge routine. Just as you might 
type it into the computer, using the Editor: 



SAMPLE MACRO POPS L6 BIT ARGUMENT 

.MACRO POP 

PLA 

SIA XI 

PLA 

STA ll+l 

.ENDN 



-FDNC PADDLE, I [ONE WORD OF PARAMETERS 



SAMPLE GAME PADDLE FUNCTION FOR PASCAL 
CThlB function provided In APPLESTUFF unit,) 

FUNCTION PADDLEtSELECT: INTEGER); INTEGER; 



RETURN .EQU 3 



POP RETURN 

FU 

PU 

PLA 
PLA 

AND tfi 
TAX 
PLA 

LDA ilC07i* 
LDY IfZ 
NOP 
NOP 
PHEAD2 LDA flC06A,X 
BPL DONE 
INY 

BNE PHEAD2 
DET 



;TEMP VAR FOR RETURN ADDR 
jNOTE: fl..35 HEX AVAILABLE 

;SAVE PASCAL RETURN ADDS 
IDISCARD I. BYTES STACK BIAS 
;£ ONLY DO FOR .FUNC ) 



J GET LBB SELECT PARAMETER 
;FORCE INTO RANGE 0.-3 

lUISCARD MSB SELECT PARAM 
JTHICCEB PADDLJES 
;INIT COUNT IN Y REG 
;COMPENSATE FIRST COUNT 

I TEST PADDLE 

IBEIAKCH IF TIMER DONE 
jELSE INC V EVERY 12 USEC 
;LOOP UNLESS 255 EXCEEDED 
IMAKE INTO 255 (MAX COUNT) 
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DONE 



LDA ff^ 
PEA 
TVA 
PHA 

LDA RETDHN+1 

PEtA 

LDA RETURN 

FHA 

filS 



;PDSH MSfl OF BETURN VALUER* 

IPUHH LSH OF HETURN VALUE 
jRESTORE PASCAL RETURN ADDR 



lATTO HETURN !□ PASCAL CALLER 



-mOC TTLOUT,? iTWO WORDS OF PARAMETERS 



ROUTINE TO SET OB CLEAR ONE OF THE TTL I/O BITS 
(Thlfi procedure provided In APFLESTUFf unit) 

PROCL'DUKE TTL0UT(S1^LECT; INTECER; DATA: HOOLEANJ; 



RETURN -EQL 





POP 


RETURN 


PU 




LSR 


A 


PLA 




PLA 




AND 


#33 


EOL 


A 


TAY 




LDA 


0C058,¥ 


FLA 




LDA 


REtUHM+) 


PKA 




LDA 


KLiUO 


PHA 




BTS 





TEMP RETURN ADDS 

SAVE PASCAL RETURN ADDRESS 

POP PARAMETERS. LAST FIRST 
GET LSB BOOLEAN DATA 1-TRUE 
SAVE BOOLEAN IN CARRY 
DISCARD MSE BOOLEAN DATA 
CET LSB SELECT 
TREAT IT MOD 4 
DODBLE, ADD DATA FtlR INDEX 
PUT I/O STROBE INDEX IN Y 
ACTIVATE l/il STRnBF- 
DTSCARD MSB SELECT PARAH 
RESTORE PASCAL RETUFK ADDft 



;G0 BACK TO PASCAL 



-HI^ 



;END OF ASSEMBLY 



The Assembled Output Listing 



Ttic preceding a^jStrmbEjr -language rcutlaQ, which we eaved In Cho 
dialteccG file named MYDlSK:ASMDEMU,TElCr , can now he assembled by the 
Apple Parscal 650? Atiseiobler* From the CociDiand level, typp Che letter 
A tor Al&semble, and a dialog slDilLar [o the Eollowlng takes plate: 

ASSEMBLING... 

ASSL"MBL£ WHAT TEXT? MYDISKiASf^mEMn 

TO WHAT CODE FILE? MYD1SK:A!;MDEH0 

6500 ASSEMBLER U.0 [D. 4] 

OUTPUT FILE FOK ASSEMBLED LISTIKG: (<CR> FOR NOWE) FKltJTERi 
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B 
t 

B 
B 
B 
B 



B 
B 



The first fespnnBe tells Cha Asseinblec to take the tejtt veralcin at the 
routine from the filE MVDlSK:ASMDEMO.TEXT . The necond response says to 
aave the a^EeDibled code version of the routine (wh^n the dESenbly Is 
complete) In Che file HYDlSK:ASrtDEMO.CODE - By using the eaae name, we 
have fewer Eilenaraes to renemberi and raost commands will automatically 
chooee the correct version (teitt vr codcj. You could havi? accompltshed 
the same thing by typing a dollar sign 1 S ) as the second response ■ 

IE the text version of Che routine had been available fn the boot 
diskette's workfUe SYSTEM, WRK. TEXT (or another workfile designated 
by Che Filer's Gfet CDnnnand ) , the Afiseribier would automatically have 
assembled that file and would autoraaClcally have stored the aasenbled 
code version as Sl-STEM-WRlt^CaDE . 

The last response (PRINTER: J sends the asseitibled listing to the 
printer, and lets Che usual Assemblet display appear on the screen- 
The acteen dlaplty loaka something like this; 

[J103SK {!> 

2 BLOCKS FOR PROCEDUFE CODE 9B34 WORDS LEFT 

[ 9027]< 13> 

I 9960]* 50> 

CUBltENT MINIMUM SPACE IS 979A WORDS 

[ 97fl71< 5&> 

CDRRENT MINIMUM SPACE IS 979A WORDS 

[ 9808] < 90> 

ASSEMBLY COMPLETE: 9^ LINES 

ERRORS FLAGGED ON THIS ASSEMBLY 

Meanwhile, the printer has been printing the i^sfiembled listing (ll we 
had responded CONSOLE: , the assembled Hating would have replaced Che 
Assembler'a usuat fitireen displfly). The asseiobled listing appears 
appronluiutely as ahovn belnvi 



PACE - 



Current loeiiior-y available: 10613 






3 ^^'i<^ 



mm 
I 



^ 00001 



mm 



; SAMPLE MACRO POPS 16 BIT ARGUMENT 
i 

, MACRO POP 

PLA 

STA £1 

PLA 

STA ^Il-f-l 

-EWDM 



13 «dti0| 

2 blockn fcpt procedure code ^BliA words left 
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FACE - ] PADDLE FlLEiASHDEHO 

99W -FUNG PADDLE,! lOHE WORD OF PARAMETERS 

Current memory available: 100^6 



t^000 



0000 



^t^m-. 




POP 


RETURS 


000bf| 


fifi 


# PLA 




0001 


«5 00 


J ETA 


RETURN 


00031 


bs 


? PLA 




000^1 


es 01 


fl STA 


KETUBN+1 


00061 


68 


FLA 




B007I 


6fi 


PLA 




P00&I 


6fi 


PLA 




00091 


6S 


PLA 




Bl9i9Aj 


68 


PU 




00ttH| 


;J9 03 


AWD 


J3 


e00D| 


AA 


TAJC 




mH\ 


68 


PLA 




B00FI 


AD 70C0 


LDA 0C070 


tVHl\ 


AB 00 


Lnv 


^0 


00UI 


EA 


NOP 




0015 1 


EA 


NOP 




00I&I 


HD 6iC0 


PREAD2 LDA 


ec0&4»x 


fl0L9| 


10** 


flPL 


DONE 


001BI 


c:e 


INY 




0fllCf 


D0F8 


HNE 


PREAD2 


001 E| 


HS 


DET 




0019* 


00 






001 F| 


A9 00 


DONE LDA 


m 


00211 


AS 


PEA 




00221 


98 


TYA 




00Z3f 


Afi 


FHA 




rniii] 


A5 01 


LDA 


RETURN+1 


00261 


48 


FHA 




B»:^^f 


A5 0(» 


LDA 


RETURN 


00291 


48 


PflA 




002AI 


60 


RtS 




002BI 








002^1 









SAMPLE GAME PADDLE FUNCTION FOR PASCAL 
(ThlB function ptovlded In APPLESTUPF unit.) 

FUNCTION FADDLE (SELECT: INTEGERJ: INTEGER^ 

HETURM -Equ ;TEMF VAR FOR RETURN ADDR 

;notc! B..35 hex available 

;SAVE PASCAL RETURN ADDR 



iDISCARD 4 BVTES STACK BIAS 
it ONLY DD FOR -FUNC } 



;CET LSB SELECT PARAMETER 
; FORCE INTO HANCF 0.-3 

iDlJ5CARD MSB SELECT PARAM 
jTRlGGCR PADDLES 
IINIT COUNT IN « REG 
[COMPENSATE FIRST COUNT 

iTEST FADDLE 
;BRANCH IF TIMER DONE 
lELSE INC Y EVERY 12 USEC 
jLOOP UNLESS 255 EXCEEDED 
;MAKE INTO 255 (MAX COUNT) 



r 

E 

i 

i 

i 

r 
f 

E 



;PUSH MSB OF RETURN VALUB-0 

;PUSH LSB OF RETDBN VALUE K 

jRESTORE PASCAL RETURN ADDR 



;Am RETURN TO PASCAL CALLER 



PAGE - 2 

AB - Absolute 
RF - Bef 

PB - Public 



PADDLE 



FILE:ASHDEM0 



SYM BOLT ABLE DUMP 



LB - Lahol 

DP - Def 

FV - Private 



UD - Undefined 
PR - Proc 
CS - Const s 



MC - Macro 
FC - Fuac 



DONT LB 00IF| PADDLE FC 

PREAD2 LB 00161 RETURN AB 0000 



POP 



MC 1 



3 
§ 



PAGE - 3 PADDLE FILE:ASMDaiO 

CuiretLt Diininiuiii space is 979A words 



m PAGE - 4 TtLOUT FlLE:ASMDEMO 

00001 .PROC TTL0UT,2 ;TWO WORDS OF PARAMETERS 

B Current niEmory available: [0056 



if^m^ 



E 



w ^ 



mm 

0^00 

mm\ 

0000 J 68 

000 1 1 35 00 

0003] 68 

00041 85 01 
0006] 

00061 68 

0007 4A 

0008] 6fl 

00091 68 

O00Af 29 03 

000C! 2A 

000DI AS 

000EJ B9 58C:0 

00111 68 

00121 A5 01 

00141 48 

0015! A5 00 

0017 1 ^a 



ROUTINE TO SET OR CLEAR OKE OF THE TTL I/O BITS 
(This procedure provided In APPLESTUFF unit) 

PROCEDtfRE TTLOUT (SELECT! INTEGER; DATA: BOOLEAN); 



I TEMP RETURN ADDR 

;SAV£ PASCAL RETURN ADDRESS 



;P0P PARAMETERS. LAST FIRST 
iCET LSB BOOLEAN DATA T-TRUE 
jSAVE BQOLF-AN IN CARRY 
iDISCARD MSB BOOLEAN DATA 
;GET LSB SELECT 
jTREAT IT MOD r* 
;DOUBLE, ADD DATA FOR INDEX 
;PUT I/O STROBE INDEX IN Y 
jACTIVATE I/O STROBE 
IDISCARD MSB SELECT PARAM 
; RESTORE PASCAL RETURN ADDR 



RETURN -EQU 


POP 


RETURN 


FLA 




STA 


RETURN 


PLA 




STA 


RETDRN+I 


PLA 




LSR 


A 


PLA 




PLA 




AND 


#03 


RDL 


A 


TAV 




LDA 


0cO5e,v 


FLA 




LDA 


RETURN+l 


FHA 




LDA 


RETURN 


FHA 
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ATS 



.END 



iGO HiVCK lU PASCAL 



J END OF ASSEMBLY 



PAGE - 5 TTLOUT FILEiASHDEMO SYMBOLTABLE DUMP 


All * Absolute LB - Label UD - Undefined 


«t - Macro 


KF - Hef DF - Def PR - Proc 


FC - Func 


PE5 - Public PV - Prl^'flte CS - Consts 




POP }iC J RETURN Afl 00\ TTLUUT 


PR 1 



PAGt - b TTLOUT FiLEiASMDEMU 

Current mlnimmD space la 979& vozda 
Asfismhly cooqilete; 92 lines 

^ Errors flagged on this AflBemblj 



Only Che aflHtJithled abject code froqi the preceding assembly IJatlng 
(Che second culumn of InfurmiiCiGn on PAGE- i and an PAGE-i) 15 aaved 
In the file IIYDI^KiASHDEMO-GODE - 



NOTES about the preceding sample asaeobly llgting: 

1) The lacaclon valuDs Jn the fiymboX table dump refer ca the 
locations In the Ust Jng- 

2) The ** 's Jq Ihe Listing Cflee PAGE- L of the listing, for 
example) call aCCenClon to Clie use of a label not yet 
defined- The Aaaembler displays one * for each hexadecimal 
digit to he filled in later- 

3J If a • appears after the location nunher at the left of the 
iietlng. It indicates that a forward reference occurting 
earlier in tbe aseerably has been resolved- The number tu tlie 
left of tlie * Id the location where the reference occurred 
while the number Co the right Is the new contents of Chac 
location. See PAGE^l of the Hating, for exacuple- 



e 


^ 


E 


§ 


r 


^ 


t 


3 


1 


^ 


i 


^ 


i 


§ 


1 


3 


g 


3 


1 





A) The Apple Pascal 6502 Assemblei: uses the following non- 
standard notation for indirect addressing: 



f 3 



Standard 6502 Asseinbler 
LOA (L0C1),Y 
LDA (LOC?,X) 
JMF (GOVECT) 
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Apple Pascal 6502 AaHembler 
LDA 0LOCI,Y 

LDA 3LOC2,X 
JMP I^GDVECT 

A Pascal Program which 
Calls the Assembled Routine 



The followinK is a saniple Pascal prograni which uses the external 
function and prccedure assembled earlier: 



PROGRAM GALLASM; 

(* QEMONSTkATES CALLING ASSEMBLY UANGUACP. PflaCEOURES ■) 

VAR 1: INTEGER; 

PEtQClilDURE TTLOUT f SELECT: INTEGER; DATA: BOOLEAN); 
EXTERfJAL; 

FUNCTION PAJJDLE< SELECT: INTEGER): INTEGER; 
EXTEHT^AL; 

BEGIN 

FOR 1:- I TU 100i* DO 
J1£CTN 

URITELNiPADDLE(iS):3,' ', PADDLE (1 ): 1) ; 

■rTLOUT(0,ODOU)J 

Em 

END. 

Compiling. Linking and Running 
the Calling Program 

To use the Pascal progtaoi CALLASM, you mist compile the text version 
shown above to make a i^oiriplled P-code version. This is done from the 
Command level bj' typing C for C(oiDplle. When you do this, a dialog 
similar to the followint takes place (our program CALLA5M was saved In 
the text file named MYDISK:CALLASM, TEXT ): 

COMPILING... 

COMPILE WHAT TE5CTT MYDISiiiCALl.AfiH 

TO WHAT CODEFILE? MYDISKiCALLASM 
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The first CEBponee tella the ComplLer to conplle the text that is 
found in Che file MYDISKsCALLASM.TfcJCT . The second responae cells the 
Compiler Co save the reaulclng compiled code in the file 
MVDtSK:CALLASM.TEXT . Again, we used Che P3me name for the ceiC 
version and foe the code vecaioTi oE Che program, to save ua 
cememberinE Cuo dlfferenC namea- (Again, we could have typed the 
aceand reeponae as S ') 

If Che test verEton of the Pascal program had been available in the 
boot diskette's workfile SYSTEM,WRK.TEXT (or anocher workfilo 
desifiTiated by the Filer's G(et eommandj, che Compiler imiild 
auComaclcally have compiled Chat test, and would have saved che 
resuicing code version as SfSTEM-URK-CODE on the hooc dlskeCte. 

At this point, if there are no errors in che program, CALLASM is 
compiledi the reaulcing P-code version is stored as HYIHSK:CALLASH.CODE . 
Messages similar to che following will Chen appear on the acreen! 

PASCAL COMPILER 11.! [623] 

< 0> 

TTLOUT [ 2533 WORDS] 

< 8>... 

PADDLE [ 2504 WORDSJ 

< ll>... 

CALLASH f 2515 WORDS] 

< 1A> 

19 LINES 

SMALLEST AVAII-ABLE SPACE = 2515 UOROS 



r-3 



I 
e 



However, CALLASM ts still noc ready to be run: the external assembly- 
language funccion and procedure in MYDISK; ASMDEMO.CODE muBC now be 
Linked into the Pascal program. To do this, from the Command level 
type an L for L<lnk, and a dialog similar to the following wiil take place: 



LlrJKlNG.-. 

LINKER II. I [A4] 

HOST FILE? MYDISK: CALLASM 

OPENING HYDISKiCALLASM.CODE 

LIB FILE? MYDISK rASHCEHO 

OPENING W¥DISR! ASMDEMO.CODE 

LIB FILE? 

MAP NAME? 

READITJG CALLASM 

READING PADDLE 

OUTPUT FILE? MYDISK: FIN ALCALL, COPE 

LINKING CALLASH ff 1 

COPYING FDNC PADDLE 

COPYING PROC TTLOUT 



(Your main Pascal program) 

CThe routine to link in) 

(Press RETURN for last Ella) 
(Press EtETURN for no map file) 

(Final product; note -CODE) 



I 



-3 



At lastl The file FINALCA].L.CODE noM conCalne your compiled Pascal 
program CALLASH CogeCher uich the Hnked-in aHEembly- language couCines 
^o" nay now XCecuCe the pragraiD FINALCALL. 



PADDLE and TTLOUT. 
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ASSEMBLER INFORMATION 



SYNTAX OF ASSEMBLY FILES 

All Dbjectfl declaCEd before Che ficat .PROC or -FUNC are available foe 
use throushout Che aagendily- No code Is allowed to be generated 
before Che first ,PRUC or .FUNC . The symbol table ia reduced at the 
beginning of each .FROC or -FUNC to che point where iC was at the 
Btart of Che first -PROC ot .FUNC . 

All aseemblles oust end with a .END . However, each -PROG or -FUNC 

before the last one la ended by che occurrence of the next .PROC or 

.FUNC - Only the laat one should end with a -END , as all cexC beyond 
che .END la igncred by the Aasembler, 

A j^eneral ayntaK dlagtan far all asaeiobly Fllea looks like thla; 



.PROC 



any r on- code 
D^tfTiltLDn-. 



.Fl'rJC 




3 ^^ 

ASSErtBL¥"PlLE SYNTAX 
^ The non-code-geaeratlng directives aze.; 



cade-REnerfl t tnp 

Dp<>raliDn9 and 

direct Ives 



^C^ 



:NJi 



.LIST .MACROLIST -PAGE 

,NOLIST -NOMACROLIST -TITLE 
-PATCHLIST 
-NOPATCHLIST 
The body of a macro definlcion ia a no n-cade—geoB rating operatloa- 



,Egu 


-MACRO 


-IF 


-DEF 


.ABSOLUTE 


.EHDM 


.ELSE 


,aEF 


-INTEaP 




• ENDQ 
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SYNTAX OF ASSEMBLY STATEMENTS 



Identifiers 

tdeoClflers are character atrlrkgE stflftlne wUh an alpha character. 
Uther characteca aaiSL be nlphanuin&rlc oe the ASCII undprllue ( ). 
Only the £lrac eight characters are mean Jugful to the ABBeinhier even 
Lhaugb more iray be entered- 

The Asaembler jnflkee only dpne pass chrough the source. On encountering 
an undefined identifier in an expression, aomething aaiat be assumecJ 
about the nature of the Identitter In order for the asaenihly to 
continue- It is tharefnre aaaumed cUat c[be undefined Identifier will 
eventually be defined as n label, which is the most probable case. 
Any idencifier vJilch la not a label imiat be defined before it Is used- 

Labels 

Unly labels and conmenta niay begin In Che first column, with no 
preceding a]iaces> Labels may optidnally be folloved hy a colon. 
It a acatement has no label, the fJrat column imist contain a space. 

Labels may be equated to an eHpreaaion containing labels and/or 
abgoluCefi. Vou must define a label before it is used unless it will 
eliEpIy be equated to another Label* 

Local Labels 

Local labels muBt have S as the fimt non-space character, and may 
be up to a digits long- Local labels jiiay not occur on the left-hand 

aide of an equate ( -EiJU )- 

Local labels flre loainly used to Jump around wfthln a small segment of 
cade without having to use up storage area needed by regular labeia* 
The local label atack nay hold up Co 21 labels. The local Inbel 
stack id emptied each time a regular label la encountered, thus 
rendering the previous local labels invalid beyond that point In the 
aseembly. An example nf the use of local labels is shown balou, where 
the Jump to label SflA Is made Illegal by the intervening regular label 
AiLALLAh . 



$03 



STA 



BNE $193 



DNE $04 
HEALLAll .EgU $ 
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jLfctiAX. USE OF LOCAL LABEL 



; ILLEGAL USE OF I45CAL LABEL 






t 

i 

i 
I 

k 

ft 
i 



i 



3 



ii 

ft : 3 



i 



Operators 

The folloving operators can be used in eKpresElons piocesaed by this 
AflseiubleT:: 

For unary opi-ratlona: 

+ plUH 

— minus 

ones complement (not available on the Apple IteyboardJ 

For binary t^erations; 
+ plus 

- minus 

"" encluHivc or 

* multiplication 

/ truncating division (DI7) 

X remainder division (MOD) 

I blt-wjse OR (not available on the Apple keyboard) 

i blt-wiae AND 

equal (valid only In -IF ) 

<> net equal (valid only in .IF ) 

All Operators have the same precedence- 

Constants 

Ail constants must start with an integer ffun through 9- 
For example, Chp hexadecima-1 constant PF must be written OFF 

The default radix is Hexadecima.!- Declnal conatanta must be 
followed by a period ( - ) . 



EXAMPLE; 



Hexadecimal: 
Decimal' 



Expressions 

EKpreaafons are evaluated by Che Assembler from leJt to right, and all 
operators have the same precedence. To override the default, lefc-to- 
cight precedence, use angle brackets <like Chisi . 

A relocatable label can be used In an address eXpreBalon such as 

LDA :U,AliEL+5 ; Legal expresBion with label 

but only If the ejipreaaion ADDS or SUBTElACTS a constant value from the 
address of the label- An expression such as 

LDA KLABEL*2 ; Illegal expression with label 

will not be accepted by the Assembler unless you are assembling usin^ 
the -ABSOLUTE directive tdlscuased later in this chapter! and EILABEL has 
previoualy been defined- 
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A relacaCable label nufit not appear In an expreaelon used to rake an 
flhaoXute conscaat. A sCanement. Buch as 

LDA ffRLABEL+5 ; Illegal use of label as absolute constant 

will not be accepted hy the Aaaerabler, 

The followlnB portion of an aaaembled llettng llluatratea expression f 

syntau as used In the Aaaeiabler. The examples are not Intended to focn ™ 

an actual, useful prograin. 



B H 



PAGE - I 



TEMPI 



Current meoiDrv available 

00001 

n000| 

00001 l*t*0A 
00BF 
li0F7 



flLEsEXPR SYNTAX 



-PROC TEMPI ; SHOWS EXPRESSION SYNTAX 

; CONSTANTS 



Com^ -EQU 10. 
OTa0 ,EQU 0BFH 
ONE0 . EqU 0F7H 



; EXAMPLE EXPRESSIONS 



A5 fl5 
2| A5 iD 






f)00A, 



000E 
0010 
B012; 

00U. 



A5 4D 

A5 0A 
A5 07 
A5 01 
A5 02 
A5 07 
A5 A3 
A5 B7 
AD BE00 



LABEL 



LDA 


5 


LOA 


5+6*7 


LDA 


<5+6>*7 


LDA 


7*6/i 


LDA 


7*<^/^> 


LDA 


6:E5 


I.DA 


5+UJ5 


LDA 


5+<ni5> 


LDA 


OTH0"ONE0 


LDA 


OT110&ONE0 


LDA 


UBEL 


LDA 


LABEL-5 


LDA 


LABEL-K5*CON[0> 



00211 A9 

LDA #LABEL 
operand not absnluCe 
E{dlt,<Hpflce>,<eBt:> 



"3 00221 A9 



t 3 

i ^ 

I ^ 

I ^ 

I 3 



0017 1 An 0900 

001A| AD 4000 

LDA LABEL*? 
lll-Eomied expression ^» 

E{dlc,<space:>,<eEc> [ Spacebar pressed here, to cnntltiue aaaembly, J WT' 

00 ID I 

BflUjf A9 85 
B01FI A9 IC 



LDA LABEL* 2 

LDA 05 

LDA *5*<CON10 / 1> +3 



LDA #tLABFCL+5> 
Operand not absolute ^B 

ECdtr,<space>.<esc> [ Spacebar pressed here» to continue asaembly. 1 
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t 3 



00231 
00231 



LDA ff<LABEL+5> 

t Spacebar pressed here, to continue aasenibly. 1 
LDA r^LABEL 
-END 



LINKAGE TO ASSEMBLY ROUTINES 

External as semblj- language routlnea C>PROC's and .FUNC's) are separately 
assembled and often stored In a diskette library file such as the boot 
diskette's SYSTEM- LXBltAftY , A Pascal host program chat uses such 
external assenbl^d routines cnust have those routines linked from 
their library filefsj into the compiled boat program's codeflle. 

A Pascal host program declarea that a routine is external in much 
the same way as a Pascal routine Is declared FORWARD- A standard 
PROCEDURE or FUNCTION heading is provided, followed by the keywcrd 
EXTERNAL. Calls to the eKternsl routine use standard Pascal syntax, 
and the Coinpller checks that each call to the external routine agrees in 
type and number of parameters with the orle'rial EXTERNAL declaration £or 
that routine- t: is the programmer's responsibility to assure that the 
as sembly- language routine respects the Pascal EXTEB^AL declaration- 
The Linker checks only that the number of words of paramatera agree 
between the Pascal EXTERNAL declaration and the corresponding aaseiDbly 
language -PHOC or -FUNC declaration- For njore information see this 
manual's chapter THE LINKER- 

When the Pascal ^oat program calls an external aaaembly Language 
routine, passed paranLeters are pushed on the evaluation stack as they 
are encountered tn the host program's calling statement- The first 
parameter is pusfied on the stack, highest byte first, then Che second 
parameter, and si on- Long integers and sets are always passed as the 
ma'xJmun number oE words allocated by the host program's long integer or 
set declaration, each word high byte first. A word indicating the 
length in words is pushed last* Strings, records, arrays, and 
VARiables are pa^^ed by address, pushing the high byte first, then low 
byte- The Pascal host program's EXTE[<NAL declaration may declare a 
VARiable without type- This allows a parameter of Indeterminate size to 
be passed by addresS' When all the parameters have been passed, the host 
program's return address (the address to which the program cwist return 
on conpletina the external routine) is pushed on the stack, high byte 
first, then Low byte- 
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In UBe, Che aaHembLy -language routloe doihC aave Che return address, 

and EttiaC puah it en the stack again Juet before recurnlng to the calling 

program. The paHaed paramtfCers are avaJlable an the stack jn the E, 

reverse order to the order In which they were originally pushed on the C 

stack. 

The coijventlona of the Hurroundlng aystem concerning ceftlater use and 
calling sequences muat be respected by writers of assembly-language 
routines. On the Apple, all roglsters are available, and zero-page 
hexadecimal locations (I through 35 are available as temporacy 
variables. However, the Apple Pascal system also uaes cheee locations 
B9 temporarieB, so you should not expect data to remain there from 
one execution of a routine to the next. You can saue variablea in 
non-zero page memory by ualEig the .BYTE or -WORD directives in your 
routine to reserve apace* 

For external assembly-language functions (.Fimc's) only, two additional 
convent 1 una mist be recognj zed: 

1) At the function's entry time, the Pancal boat program pushes 
two words (four bytes) of zeros on the evaluation stack after 
any pass&d parameters are put on the stack and before the 
return address la pushed on the stack- 

2) At the function's exit time, the .FUNC must push the function 
result <a scalar, real, or pointer, maximum two words), high 
byte CJrst, just before pushing the return addresa on the stack. 



S Ti 



For an exataple of an external assenbly-lanfiuage procedure, an external 
asHembly-lanfiijage function, and a Pascal hi:et program which calls these 
routines, see Che EXAMPLE earlier In this chapter. The EXAMPLE alsu 
demonatrates the handling of the return address, passed parameters, and 
returned function value in assembly-language routines. The external 
TQUtiaes In that example are manually Linked into the Pascal calling 
program. For informatinn about installing a routine Into the system 
library, see this manual's chapter UTlliITY PROGRAMS. 
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THE ASSEMBLER DIRECTIVES 



r'3 

i >! 

E i 
i 3 

i 3 



AN OVERVIEW 

Assembler directives talso re£erred to as *'pseudo-opH"l let you tell 
the Aaaombler to do varioua functions other than provide directly 
eKecutable code- The following directives are coinnion to all versions 
of the UCSD Adaptable Assembler, includlns the Apple Pascal 6502 
Assembler, but loay dJfEer from individual loanufacturer's standard 
ayntax> 

In the following deacrlptlone of directives, square brackets [like thia| 

are mecasynibols ::hat denote optional elements which you may supply. 
Angle bracketfi ^llke CM3> are met a -symbol a that denote required 
elementa which you muBt supply- If an element type is not shown, it 
cannot be used in that situation. 



example: 



[label] -ASCII "^character 0trlng>" 



This notation indicates [hat you may supply a label, but It is 
not necessary, and that benween the required double quotes you 
must supply the character atrlng to be converted (not necessarily 
the words "character string"). The bracket metasymbols are nat 
to be be cy[>ed- 



The fallowing terms represent general concepts in the explanation of 
each directive: 



TEKH: 

value 

va^luelJsc 

identifJerllat 

expression 



UEFIHITION: 



Any nunetlcel value, label, constant, or 

expression- 
A llBt of one or more values separated by 

coimaas- 
A list of one or aare idenClfiers separated 

by commas- 
Any legal eKpression as defined under SYNTAX 

OF ASSEMBLY STATEMKNTS - 
Identifier [linteger] A Hat of one or more identi f ier : i ntcger pairs 
IlB.t separated by conmiaB- The colon-integer Is 

optional In each pair and the default is 1- 



Sojall examples are included after eacb directive definition to show you 
Che specific syntax and form of that directive. The EXAMPLE assembly- 
language routine earlier In this chapter la used to show the combined 
use and detailed examples of directive operations. 
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ROUTINE-DELIMITING DIRECTIVES 

Every assembly must Include at l^ast one -PROC or -rUNC, and one -END 
even in tha case of stand-alone code which will not be linked Into a 
Paecal MoaC tc.g., the inlecpftter) . The niDac frequent use of the 
Asseoiblert however, will be small routines intended to be linked with 
a Pascal host* In this case, .PHOCa and . FUJJCg ate used to Identify 
and delimit the asBembly code to be accessed by a Pascal external 
prcceduce oc function. The -END appears at the end of the laat 
routine and swerves as the final delimiter- 

AeEerencefl to an asaeoiily-lflnguage ,P[lOC or .FUhC are made in the 
Pascal host prograra by uae o£ HJfTEHNAL declarations- At Che tine of 
this declaration the actual parameter names must be given- For 
Gxan^le, if the PaacaX host's declaration is: 

PROCtUUHE fARRLECX.YiREAL); 
EXTEIWAL; 

the associated declaration for Che assembly-language -PROC would be 

■PROC FARKLE.ft 

A -FRDC:, -FUNC, or any aaaembly totitine should be inserted into Che 
S^STKM-LIBKAK'T so that It can be referenced by the Linker and linked 
into the Pascal host program al Htun time. An alternate method would 
be CO execute the Linker and tell it what files Co link in- Either 
method works- However, if the Pascal linsC J6 updated and the assembly 
routines have not been Installed In the SYSTEM, LIBRARY, the Linker 
will have to be exua^teil again after each host program update- 
Thereforii, wh Huj^gest Chat the routines be inserted into the 
SYSTEM- LIBRARY to avoid this repetUlon- If the Linker ia called 
auCoiJiatically , using the E(un coomiand, It will automatically aearcli 
Che SYSTEM. LI bHARV for Che appropriate definition of the aasembty 
routine and link the two togetlivr. 

The £>lAMPLE earlier in this chapter sliows Che use of aaaembly-lanKuafie 
routines from a Pascal host proj^tam and demonstratea the manual 

linking process- Wore information on linking appears in thlH manual's 

chapter THE LINKER- For inforjnatlon on uning Che aystera librarian to 

install a routine Into SYSTEM -LIBRARY , aee this raanufll'a chapter 

UTILITY PKUGRAHS* 



PRUC 



Identifies a procedure Chat teCuma no value- A -PROC is 
ended by the occttirence of a new .PROC ■ -FLINC , or ,END 

FURM: -FRtJC <ldentlfler>Uexpceaa3on] 

[expression] indicates the number of words 
□f parameters expected by this routine. 

The default is 0- 

EXAtlPLE: ,PKOC ULURIVE,2 
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-FUNC 



Identifies a function that returns a value- Two words of 
space to be uaed for the function value will he placed on 
the acack after any parameters- A -FUTJC la ended by the 
occurrence of a new -PROC 



form; 



EXAMPLE: 



-FUNC , or -END - 

-FUNC <]dentlfleT>r, expression] 

[eKpreaalonJ initicates the numbez- of words 
of parameters eiipected by this routine- 

The default is 0- 

,FUNC RAfJLOH, 4 



-END 



Used to denote the physical end of an asseobly- 
FORM: -Elffl 

EXAMPLE: .END 



1-3 



_ LABEL DEFINITIONS AND 

a SPACE ALLOCATION DIRECTIVES 



i 3 
t 3 

i ^ 



-ASCII Converts chara[:ter Values to ASCII equivzilent byte 

constants and places the equivalents into the code Stteam. 

FORM: [label] -A^CII "^character string*'' 

where ^character strlng> Is any string o£ 
printable ASCII characters, Including a apace. 
The length of che string must be less than BO 
characters- The double quotes are used as 
delimJEets for the characters to he converted- 
If a dbuhle quote is desired in the string, It 
must be specifically inserted using a -BYTE . 

EXAMPLE; -ASCII "HELLO" 

for Che insertion of AB"CD the code must he 
conatrycted as; 



-ASCIX 

-BYTE 
»ASCII 



■^AB" 

12 
"CD" 



J An ASCII '^ 
Note: The 22 is the hexadeclraal ASCII code for a double quote. 



i>^ 



6502 ASSEMBLER 159 



■ BYTE 



.BLOCK 



MORD 



AllocaCGH a byte of apace into the codp streani for each 
Vflluo Hated. Each value actually stored by the couCtne 
muBt have a value between -IIS and +255* If the vaiue is 
outside of Chl3 ranfie an error will be flagged. Aesigne 
the aBHOCiated label. If any, to the address at which the 
byte vas atared. 

FORM: [label] -BYTE [value llHt] 

Ebe deEault for no stated value la 0, 

EXAMPLE: T01P .BYTE 4 

the aasociated output would be: 04 



E ^ 



Allocates a block of space into Che code streaii] for each valueB 
listed- Ainaunt allocated is in bytes. AfiBDClatea the E 
label (if preflentj with the starting addreaa of the block 
allocated. 



FORM! 



[label] .BLOCK <lenftth> [ .value] 



^lensth> Is the the number of bytes to hold [he ■:value> 
specified. The default for no seated value is 0. 



EXAHPLH: 



TEHF . BLOCK 4, 6 

the assaciated output would be: 



06 
B6 

06 



C four bytes with the value 06 ) 



AllocateE a word of space in the code stream for each value 
in the valuellst- Associates the declaration label wltb 
the word apace allocation. 

FORM: [label] -WORD o/aluellao 

EXAMPLE: TEHF .WORD 0,2,i,..» 

Che asflDClated output would ber 



(vorda with these values in chem] 



000Z 

000A 



i 

i 
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EQU 



.ORG 



.ABSOLUTE 



EXAMPLE: 



Ai 



A2 



.WOHO A2 



.EqU S 

-WORD 5. 



5 denotes LC value 



rhe statement A2 -EQU 5 aaalgns the Current 

value of the location counter (LC) to the label A2 
If the value of the location counter Is 50 at the 
'£QU I the associated output would be: 

00^0 ( asaigniiient due tc the value of LZ ) 



ff005 ( aEsignment due to the .WORD 5 1 



AsBjgna a value to a label* Labels may be equated to an 
expr^aalon containing labels and/or absolutes- One muat 
define a label before it ie used unleaa It will simply be 
equated to another label. A local label may not appear 
on the left-hand aide of an equate ( .EQU ). 

FORM: ':label> .Equ <value> 

EXAMPLE i BASE . EQU R6 

Taken the operand of .ORG as the ofEseti celatlve to the 
start of the aaaembly Eilei where the next word or byte of 
Code la to go. Wards or bytes of zeros are produced to get 
the current location counter (LC) to the correct va.liic. 



FORM: 



EXAMPLE: 



.ORG 



.ORG 



<value> 



01)000 



If a -ABSOLUTE occurs before the first ,PROC then all 
■ORG'a are interpreted as absolute mentory locations- The 
user iiLust take responsibility for the correct loading of 
the produced cede flla. The use of -ABSOLUTE has the 

effect o£ cancelling the generation of relocation 
information. Further, any defined U-P' i non forward- 
EeEerenced) labels may be treated as absolute numbers. 
Thus such Labels nay be multiplied and divided, etc. 
-ABSOLUTE must occur before the first .PPOC and is set for 
the entire assembly. 



FOBH: 



EXAMPLE: 



-ABSOLUTE 



-ABSOLUTE 
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IKTEEIP 



Interprecer relative locacloas are specified by che \iae at 
.INTERP In an expression. Further labelfi may dellned as 
incerpreter relative In the [oanner shown In the exflmple. 
The rules regardlnfi Che uae of guch labels are Che agme as 
for any other specially defined labeLa (e-g-, -PUBLIC and 
.PRIVATE), Locaclons whose values depend on interpreter 
relative labels or expresBlone are listed In a fourth 
relocation LiHt at the end of Che aaaemhly procedure- 



EXAMPLE: STUFF 



EQU 



.INTEHP+25 



Certain Interpreter entry points nay be useful, using an 
Instruction sueh as 



Eg 



expanded line- Coramenta ocdurrtna In the macro definition are not 
repeated In the expanaion. 

-MACRO Indicates the start of s macro definition and gives It an 

identif ler- 



-ETOH 



Indiciitea the end point of a loacro definition^ 
FOart: -MACHO <:ldentifier> 

• ; (macro body) 

-ENDM 



LDA 



!-lHTERP+Ti 



EKAMPLE: 



with these valuea of n: 

n^0 Addreaa of Che execution error routlnei displays 

error message using Che error number in the A register- 

n-2 Addreaa of the BIDS jump tsblej handlea Input and output 

n-4 Address of S^^SUOM; system's comrmnl cat ions area of Che 

P -machine- 

MACRO FACILITY DIRECTIVES 

A macro is a named section of text thaC can he defined once and 
repeated in other places simply by using its name- The tejrt of the 
macro may be parameterized, so that each Invocation results in a 

fJlfferenC voralon of Che macro contents. The entire macro deflnlcion 
may precede the first .PROC or -FUNC of the assembly file* 

At the Invocation point, Che macro name Is followed by a llsc of 
parameters, each terminated by a comma (except for the laac one, which 
is terminated by end of line or the comment Indication ( j )* The tent 
of the macro definition, modified by substituting the Invocation 
parameters, la Inserted (conceptually speaking) by the Assembler at the 
invocation point- Wherever ^n (vhere n is a single declraal digit 
greater Chat zero) occurs In the macro definition, Che text of the n-th 
Invocation parameter in substituted- Leading and tralllnE blanka are 
stripped from the parametor before the substitution. If the macro 
definition includes a reference Co a parameter not provided In a 
particular Invocation (too few pjrameters ar no parameter before a 
terminating comma), a null string la substituted, 

/b macro definition may not contain another macro definition. A 
definition can certainly, however, include macro invocations- This 
"nesting" of macro Invocations is limited to five levela deep. 

The expanded macro is always Included in the listing file funloss 
'NOMACROLlST la in effect al the point of Invocation)- Macro 
expansion ceKC Is flagged, in the HsCtng, by a ff Just left of each 



162 APPLE mSCAL OPERATING SYSTEM 



-MACRO HELP 

ST A tt 
LDA 3:2 

-ENDM 



; < comment > 
J < comment > 



E 


i 


i 


3 


1 


3 


i 


^ 


i 


3 


B 


3 


t^ 



The assembly listing beginning at Che point where this macro 
was invoked may look like this: 





HELP 


ALPHA, BETA 


* 


STA 


ALPHA 


ff 


LDA 


BETA 



The statement HELP calls the defined macro and sends It two 
parameters, ALPKA and BETA- These parameters are in turn 
used In forming the macro expansion (flagged in the listing 
by H signs) that fallows the Invoking statement* In the 
ej^ansion, Che First calling-statement parameter (variable 
ALPHA) is substituted for the definition's idenClfler XI , 
and the second parameter (variable BETA) is substituted for 
the identifier 7.2 - 

The following portion of an assembled llsClng llluatraEes the 
syntax used when defining and Invoking macros- The procedure 
Itaelf is not meant Co be an accualt useful program- 



PACE - 1 TB1P2 



FILE :MACROC ALL 



-PHOC TEMP2 ; SHOWS SYNTAX OF HACRO CALLS 
Current memory available! 10088 

; CONSTANTS 



fl00fl 






ij0Br 

00F7 



CON10 -EQU 10. 
OTH0 -EqV 0BFH 
ONE0 -EQU 0F7H 



; MACRO DEFINITIONS 



-MACRO M2 
CLC 
LDA PREDEFL+Sl 
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mn 



AS 35 



-KNDM 

.MACRO TESTM 
MP %\ 
UJA »S->rX2 

H2 %2 ; MACRO CALL WITHIN A MACRO DEF'N 
LDA 13 
LD4 14 
LDA 15 
JHF Xb 
-ENDM 

PRHDtFL LHA 5 i ^ PRE-DEFTNED LABEL 



E 

e 

ft 



00021 




00021 




000? 1 




00071 




0002 [ 


AC 0000 


00051 


A9 ^ 


00071 




0007 1 


la 


00031 


AU 3S00 


000fi| 


A9 55 


000UI 


A9 06 


000^^1 


A3 01 


00UI 


4C *■** 


00141 




00UI 




00UI 


IB 


0015 


AD 0500 


n0IB 




00I8I 




00181 




BBiei 




00iB| 






JMP 


DDt Qncugh nperands 


E<dtt 


<space>,<eac> 


Niai 




fl0iei 


A9 0F 


00IAI 




001AI 


18 


001BI 


AH 0A00 



; MACRO CALL WITH ALL PARAMETERS Ij 
i & NO LEADING OR TRAILING SPACES 



TESTM FHEDEFL,<5*CON10+6>,#55,tf6,l,LABEL2 
JMP PPECEFL 
LDA ff5+<5*CCMlfl-l-6> 
MZ <:5*CON10+6> 
GLC 

LDA FREDEFL+<5*CONl0+6> 
LDA *55 
LDA nt 
LDA 1 
JMP lABELZ 



i 
r 



MZ 5 
CIC 
LDA PREDEFL+5 



SIMPLE MACRO CALL 



; MACRO CALL WITH NUL PARAMETERS 
; AND LEADING & TRAILING SPACES 

TESTM .CON10. , XX ,0F0H, PREDEFL 



{ Spacebar preBsed hecG, to continue ssaeiably. J 



JMP 

LDA #5+CONl0 

H2 CON 10 

CLC 

LOA PREDEFL+CDH10 
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i ^ 
i 3 

IS 3 

a, a 



LDA 
111 farmed operand 
E (dit ,<epace^,<eac> 



[ Spacebar prpssed bere, Co continue flesenbly. 1 



001EI 
00 IE I 

00211 
00231 
00261 
00261 



AD **** 
A5 F0 

iC 



» LDA 

i LDA XX 

# LDA 0F0E 

i JMP PREDEFL 

■ END 



CONDITIONAL ASSEMBLY DIRECTIVES 

CondlcioneU «. .«od to ..l^ctlv^l, «cLnd^ « include 7/'™^ "' 

ll^^.tpa IS f«l.., the Ae.e.bl.r simply dl.cerd. th,. text un 11 a 
!^C u r^^thed. It there Is . .ELSE directive between he -IF ^d 

;-L^jrUT^e:^:.rtL^t:;r.^?:.i^r.^fsr^f"t^^ ius:.„ .. 

E^^r^e un..e™bled pact .f the .=.ditlcn.l will .=t be In^Lded 
In any listing. Condttionsla may be nested. 

The cendltl^al expreaslen take, one ef twe iorm«. f^"'^^'!,*^ 
eomal ^rith,netlf/l=.Eital expteBsion used elsewhere In the Asse»blec. 
thlTtype of expreS6l-n Is considered false if it evalnntee tn .ero; 
Lrn^ otherwise. The second Eon. of =""""''"^1 «"?"";'"',;;„„„. 
competlscn for equality (indicated by - ) cr Ineqn.l y "^^ ""^ 
by o ). Qne ™y compare strioes, characters, or arlthnieclc/loel'^^l 

eKpreaaions. 



-IF 



-ENDC 



-ELSE 



tdentlflGB Che beginning of Che conditional- 
IdentLflea the end of a conditional . Lf 

Identifies the alternate to the -IF If the conditional 
exprsaalon la equal tc then tlie else portion is used- 

FORM: llabell -IF <expresaion^ 



[ -ELSE 1 



-ENDC 



; (only IE there 1b an elflc) 



where the expreHslon l9 Che ccndiclonal expression to be net. 
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EXAMPLE: 



■IT 1ABEL1-LABEL2 



iArlthmeClc expresalon. 
; Thts tPKC ass^Dibled 
; only if auh tract ton 
; result Is non-aero 



I H 



w ^ 



IF ^'11" ■■■STUFF" 



t 



ENDC 



-ELSE 



ENDC 



HOST-COMMUNICATION DIRECTIVES 



The dlrecttvefl -CONST , -PUBLIC , and -PRIVATE eltow the Bharlng of 
Information arid data apace between an aHsembly rouclne and Che hose 
pcQgran which uaeB that routine. These entetnal referencea miac 
eventually be reaolved by the Linker- Refer to this oiflnual's chapter 
THE LINKER for further detallE, 



E 



CONST 



Allows glnbfllly declared conatflnta In Che host prograai to be K 
accessed by the aaaembly couCine- .CONST can only be used In E 
a program to replace I6-blt relocatable objects- 



FORM! 
EXAMPLE! 



-CONST ■cldentlflerll9t> 
t see example after -PRIVATE ) 



. PUBLIC 



Allows a variable declared in the alobal data oegjoenE of 
the host program En be used by both the as seinbly- language 
routine and the boat program- 

FORH: -PUBLIC <ld[intlf ierHst> 

EXAMPLE: f gee exflpiple after -PRIVATE J 
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6 
E- 



jCoinparlaon ejipresBlou- 

! This text aaaeinbled 

i if Bubtracrlon above 

; was true and If te«t 

; of first paranieter 

; tassume we're In macro) 

i Is equal to "STUFF^'. ^ 

; TecminateH nested cond- V 



Thla text aaaembled If B 
subtraction result was I 
Zero* 

._ ._^ 

of conditional- 






■PtlVATE Allots variables of the asaembly routine to be stored In 

the host pcoaram'a global data segment and yet be inaccessible 
to tte host proaram. Theae variablca retain their values for 
the entire execution ol the progfain- 



FDRM: 



-PRIVATE <ident If ler[: Integer J list> 



The Integer Is used to coniniunlcate the number of words to 
be allocated to the identifier. The default is one wjrd- 

EXAMPLE: ( for -CONST, -PRIVATE, and -PUBLIC ) 

Given the following Pascal host program: 

PROGRAM EXAMPLE; 

CONST S£TSIKE-5a; LENGTH=ea; 

VAR 1, J, F, HOLD, COUNTER, LDC:INTEGER; 
LST1:ABRAY10..9] OF CHAR; 

BEGIN 



END. 



and the following sectlnn of an aseenihly routine: 



.CONST 

-PftlVATE 

-PUBLIC 



LENGTH 

PRT,LET2!9 

LDC,I,J 



This will allow the constant LENGTH to be used In the assembly 
routine fllniost as if the line LENGTH -EqU 80- lied been 
written. (Recall the limitation mentioned above for using 
-CONST Identifiers.) The variables LDG , I and J are to 
be used by both the Pascal boat and the assembly routine, 
while the variables FRT and LST2 are to be used only by the 
SEHenbly routine- f\irther, the LST2:9 causes the variable 
LSTZ to correspond with the beginning of a nine-word block 
of spade in the Pascal host's global data segment- 



EXTERNAL REFERENCE DIRECTIVES 

Separate routines may share data structures aad subroutines by linkage 
from one aGsembly routine to another aaaembly routine. This la made 
possible through the use of .DEf and -REF . These directives cause 
the ABsembler to generate link Information that allows two separately 
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aHBembled toutlnes ta be linked Cogethcr. B7 using -DEP and .REF 
one assembly routine may call flubroutines found In another assembly 
roacine- One routine placed In 3 library fj.le such as the booc 
disteCCe'a SYSTEM, LIBRARY can contain a large number of frequencly 
uaed subroutines which are aII available to other routines. 

The use of ,DEF and -REF ta Blnillar to that of -PUBLIC . .DBFs and 
-REFe ansoclarie labels between two nasembly routines rather than 
between an assembly routine and a VsBca.1 host program. Just hs with 
-PRIVATE and , PUBLIC , these external references nuBt eventually be 
resolved by the Linker- If such resolution cennot be accomplished, 
the Linker wlli indicate the offending label, NaturalJy, the 
Aasamblor cannot be expected to flag these errors, since It has no 
knowledge of other aesemblles. 

The host asHembly routine imiat be linked to Its external asaeiubly 
subroutineH BEFORE that host assembly routine can be linked Into a 
Pascal host program or UNIT as an EXTERNAL procedure or function. 



DBF 



Identifies a label that Is defined tti the current routine 
as being available for use (by (Ueana of -REP ) from -FROCs 

or -FUNCs in other assombly-language routines- 

SotBJ TTie -PROC and the , FUNC directives also generate a -DEF B 
vltb Che same name- This allows a host assembly routine 
to call eKCcrnal -PROCs and -FUNCa if the host assembly 
routine has defined them in a -HEP - 



FORM: 



EXAMPLE : 



■DEP <ldenttflcrllat> 

The following sketched-nut routine declarea a -DEF 
for the labels DOIT and THINK - The subroutines 
bearing the labels DDIT and THINK may then be used 
by other assembly rcnjtlnes taee example for -REF)- 

.FROC FARKLE, 3 
-DEF DOIT.TUINK 



DOIT 



THINK 



BNR THIWK 

LDA 

■ 
RTS 

LDY 

RTS 
<END 
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,H.EF 



Identifies a label used in the current routine which refers 
to a label declared as available (by means of -DEF ) in 
another routine's -PROC or -FUNC - During the linking 
process, corresponding -DEFa and -REFs are matched. 

Note- The ,PROC and the .FUNC directives aiso generate a 
with the same name- This allows a host assembly 
routine to call external -PROCs and .mCa if the host 
aasembly routine has defined them In a -REF - 



.DEF 



FORM: 



EXAMPLE! 



-RBF 



<ldentl£lerllBC> 



The following sketched-out aseembly-Uneuege 
routine declares a »Rf,F for the external label 
DOIT ( DOIT was declared aveilflble for such 
ceference by the -DEF in the previous eKainpl-e) - 
It then uses that Iflbel Just as If It referred to 
a labelled subroutine wlthio the routine Itaelf- 



,PROC SAMPLE 
,REF DOIT 



JSR DOIT 



,EN1> 



Kote' The assembly routine containing -PROC FARKLE ™kust be 
linked from its library codeflle into the host assembly 
routine containing -PROC SAMPLE before SAMPLE can be linked 
In aa an EXTERNAL procedure to a Pascal UNIT or program. 



LISTING CONTROL DIRECTIVES 

The listing control directiver, detenniue what Is sent to the output 
file that Is specified at assembly time. In reaponee to the prompt 

OUTPUT FILE FOB ASSEMBLED LISTING: ((CR> FOR NOME) 

If no Ustlng output file Is specified (by juat preaalng the HETUHM 
key), then all UaClne control directives are almply ignored as 
Irrelevent- 
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• LIST 
and 
-HOLIST 



AlloVB selective listing of asserably rDntlnea. Listing 
gOEfi CO Che specified output file when a .LIST Is 
EncDunterud. The -UOLIST ±a used Co tucn off the .LIST 
option. Listing may be turned on and off repeaCedly Hitkln 
an aaserahly. -LIST la the default state. 



FORM: 



■ LIST 



■NOLIST 



■HACROLIST Alloufl selective listing of macro expansionfi. In general 
^"■^ ^" flaaemhled llflcins uill contain the textual expanaton at 

.NOHACROLISX 3 macro if the .MACRQLIST option was in efEect when the 
jDflcro was defined. On the other hand, an assembled 
listing will not contain the textual expansion of a macro 
If the .NOMACROLlST option was in effect i^en the macro was 
defined. These options infly be uaed repeatedly throughout 
an assetnbly, to Hal the expansions of certain macroa 
selectively. 

Macro expansion text Is ElaEgcd In the Hating hy a ff to 
the left of each expanded line. Coramenta occurring in the 
macro definition ace not repeated in the expansion. The 
assembled listina of the EXAMPLE earlier in this chapter 
ahouB Che macro PUP defined on PAGE-a , and listings of the 
macro expansion appear on PAGE-1 and PAGE-A - 

When assembling nested mscro Invocations, listing of 
textual eitpanslon continues until the Assembler encounCecs 
the first macro defined with -NOMACBOLIST in effect. 
Listing does not resume until that macro's invocation is 
corapleCe, regardless of the listing state o£ the macros 
invoked by the non-listing niacro. 

The .LIST and .NOLIST npUons take precedence over the 
-MACHQLIST and .NOMACROLTST options. The Assembler 



defaults to the .MACROLIST state. 



FORM: 



EXAMPLE: 



MACKOLIST 



NOMACHOLIST 



■HOMACHOLIST 



■ PATCULIST 
and 
NOPATCHLIST 



Allow control over listing of back-patchea niade to the code 
^'J-^- These options loay be used repeatedly throughout an 
assembly. 



When an undefined label is encountered, the assembled 
listing shows one * for each hexadecimal digit to he 
filled In later. For eKample; 
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IL9 10'* 



BPL DONE 



K ^ 
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f 3 



.PAGE 



■TITLE 



Uhen Che fofward reEerence is reaolved, the back-patch is 
listed In the Com 



119* m 

llFl AS 



DONE IDA ff0 



uhere the number to the left of the asterisk is the address 
of the patched location and the number to the right of Che 
asterisk Is that location's new value. See PAGE-I of the 
asserrbled listtng of the EXAMPLE, earlier In this chapter, 
for in illustration of bacli-patch listing. 



.PATCHLIST Is the default state. 



FOHM: 
EXAMPLE! 



-PATCHLIST 
-HOPATCHLIST 



.NO PATCHLIST 



Allowfl the programmer to explicitly ask for a top of form 
page break in the listing. 



FORM: 
EXAMPLE: 



.PAGE 

.PAGE 



Allova the titling of each page if desired. At the start of 
each procedure the title ia set to blank'i and must be reset if 
title is desired. The title Is only cleared at the start 
of the file. In the EXA>tPLE assembly listing earlier in 
this chapter, the title SVMBOLTABLE UUMP was not set by a 
.TITLE directive. That heading is always used on pages 
conteining symholtable dunrps. Upon assembling a further 
procedure the heading printed returns to uhat it was before 
the symboltable dump. 



FORME 



.TITLE ■'<title>" 



wbeco <tl.tle> is any string of printable ASCII characters, 
Including a space. The length of the string must be lesa 
than B0 characters. The double quotes are uaed as 
dellnltera for the string, so a title may not include Che 
double quote character. 



EXAMPLE: 



■TITLE "QBCia INTERPRETER" 
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FILE DIRECTIVE 



FORM: -INCLUDE <fllenarDe> 

whert Che fllenatae speciflos an asaeiobly- 
languflge texCflle To be Included- 

If you don't add the sufflu .TEXT the aystera will add It for ^ 

yau. The last character of the f 1 lenaiBe must be thp J 

last non-space character on Chat line {no comnEnt may follau 
on the aame line). 



I 

INCLUDE Cauaea thi* indicated source file to be Incladed at thai point, fi I '3 

g 3 



CORttECT EXAMPLE: 



CORRECT EXAMPLE: 



-INCLUDE SHORT ST ART. TEXT 

-INCLUDE SHORT START. TEXT 
; CALLS STARTER 



INCORRECT EXAMPLK: -ENCLITDE SHORT START. TEXT ; CALLS STARTEH 

The lac lude-f lie's text 3h treated hy the assembler Just aa 
if ynu had typed chat text Into the original file at the 
position of the .XNCLUDE directive- For eKample, ]f the 
included ftle contains a .END , the aBBenbly la terminati-d 
ac that point- 



Notei For a iJat of Assenihlei error ireasages, see the appendix at the 
end of this manual- 



E 
g 



LABEL DEFINITIONS AND 
SPACE -ALLOCATION DIRECTIVES 



[label] 


.ASCII 


"^character BtrlPg^" 


Ilahel] 


-BYTE 


[valuelistj 


[label] 


-BLOCK 


<lpnBth>[, value] 


[labelj 


-WORD 


<Vflluelist> 


tlabel> 


-EQU 


<value> 




-ORG 


<Value?i 




-ABSOLUTE 




.INTERP 





MACRO FACILITY DIRECTIVES 



.MACRO 
-ENDH 



<ldentlfier> 



ASSEMBLER DIRECTIVE SUMMARY 



CONDITIONAL ASSEMBLY DIRECTIVES 

[labelj -IF ceKpre3Blon> 

[ -ELSE J 

-ENDC 



Inserte ASCII of chars. 
Inai-rtG byte of value- 
Lnserta block of value - 
Inserts word o£ value- 
Aaslgna value to label- 
Next byte aC start oE 

aEsembly file + value. 
Precedes lat -PROC; all 

-ORGfl put Rent byte at 

abfl. location ■ value- 
lac loc. of interpreter* 

in relative-location 

eiipresaionB. 



Begins a rwero definitiOTin 
Ends a inacro definition. 



Be;-lns condic'l asseuiblyn 
Lf true, aaBecibles next 
text lup to .ELSE ]; 

if false, only text 

after a .ELSE - 
Ends condlt'l assembly. 



META5YMBOL NOTATION 

Square brackets [like this] surround optional elements which you nay 
flupply- Angle brackets <lSke thl8> surroiind recfulred elements which 
you must Supply- The inetaaymhol brackets and the brief definition at 
the end of each line are not to be typed- 



ROUTINE DELIMITING DIRECTIVES 



.FROC 
-FUNC 
-END 



<identi£ler>[ ,eKpreas JonE 
<J dent 1 £ ier> I , express! on^ 



Begins a procedure* 
Begins a function* 
Ends entire aasembly. 
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5 § HOST-COMMUNICATION DIRECTIVES 



3 
3 



g 



-CONST <ldeiitifierliflt> 
-PUBLIC <ldeatlflerltHt> 
-PRIVATE <ldentifier|:lnteper] ll5t> 



Takes value Eron global 

const in Pascal host- 
Uses a eIoJ'i^I variable 

from the Pascal host- 
Variable not accessible 

to the Pascal host. 

Oefaillt :1 ward/idsnc 



EXTERNAL COMMUNICATION DIRECTIVES 



»DEF 



,REF 



<ldentiflerliflt> 



<identiflerllac> 



Makes label available 

to other routines- 
Label refers to another 
routine's -DEF'd label* 
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LISTING CONTROL DIRECTIVES 



•LIST and -NOLIST 

-MACROLIST and -NOMACROLIST 

.PATCHLIST and .KOPATCHLIST 

-PACE 

-TITLE "<cltle>" 



FILE DIRECTIVE 



INCLUDE <£lJ.ename> 



Turns afisenihly Hating 

on and off. 
Turns listing of inacro 

sHpansionB on and off- 
Turns listing of back- 
patches an and aff. 
Pura pagG-feed In listing. 
Titles each page of cur- 
rent .PHOC or -FUNC , 



Includes nained text file 
in the aaaecnbly- 




L 

Note: Additional information can be found In this laanual'a chapters £ ^S_^t 

THE LtNKEJt (Linker Information), UTILITY PHaCRAHS (inatalllnft routines H^P 

In SYSTEM. LIBRARY), and in the TABLES appendix fAsaerabler error meesflgeaj- ^^^ 
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TNTHODUCnOK 
Tllaktflles Heeded 
RISING THE LtNKEE 



INTRODUCTION 



The Linker Is Invoked automfltlraLly if needed when you type R £or R(un 
or is invoked cxpllclcly by typing ], foe L(lnfc. when at the outecmoeC 
Comnand level. The Apple Paecal Linker lets you combine code files 
which may he compiled P-code or assembled machine code, Into the ayate 
wnrkftle or another specified codeflle- Thla prnvldea a vay to 
incorporate certain UEeful routines Into your programe without having 
rewrite or even recompile or re-assemble these routines. For ejiample, 
you mifiht wish to use a faat asaembly-language routine for some "real- 
lime" application. This routine could be assembled Hepatotely, stored 
In a library, and eventually accessed via the Linker- 



to 



To link 
pfOgran 
Compiler 

The tlonp 
executlo 
shows an 
P rogram , 
I'ot more 
see thla 



In routines (either procedures or functions), a Pascal calling 
declares those routines to he EXTERHAL . Thla notlflea the 
that the routines may be called, but are not provided yet- 
iler will inform the system that linking 1b required before 
n- The EXAMPLE In this manual's chapter THE 650? ASSEMBLER 
aBsembly-language procedure and function, s Pascal calling 
and the linking process needed to combine the two portions- 
details about the Linker infonuatlon stored with codefllea^ 
manual's appendix, FILE FORMATS- 



The Linker Is also used to link, in certain kinds of Paacal DNITa, A 
UMIT is a group of related routines which vlll he used together to 
perform a common cash- Any Pascal files which reference UNITa or 
EXTERNAL routines, and which have not yet been linked, may be compiled 
and saved but will need to he linked before they can be executed. 

The DNITa that are provided with the Apple Paacal language, auch as 
TURTLEGHAPHICS and APPLESTUFF , are special INTRINSIC UNITa, which are 
"prellnked" and are USEd directly from SYSTEM. LIBRARY without linklng- 

For more InformflCton on Pascal UNlta, see the Apple Pascal LanEUfige 
Reference Manual* For Information on linking from one assembly 
routine Co another, see this loanuai'a chapter THE 6502 ASSEMBLER- 



DISKFILES NEEDED 



Host codeftle needing 
eHternal routines 

Library codefiles holding 
eiiternal rouclnefi 



(any diskette, any drive; deEault 
is hoot diskette's code workfile 
SYSTEM -WRK, CODE, any drive) 

(any diskettes, any drives; default 
is boot diskette's lihcacy file 
SYSTEM* LIBRARY, any drive) 



mi 




E 
E 
E 

E 
t 
E 



E 3 



The folloHlnfi files allow you to use the Linker eKpltcltly: 

SYSTEM. LINKER {any diskette, any driue; required) K 



176 APPLf PASCAL OPERATING SYSTEM 



E 
E- 



The fnllQving dl^kfiles allnw you to invoke the Linker autonaclcallyt 
using Che R(un cdminand; 



3 

3 

3 
3 



Host program needing 
external rou tinea 

SYStai- COMPILER 



3 SYSTO*]- EDITOR 
SYSTfM- SYNTAX 



SYSTEM. LINKER 
SYSTEM -LIBRARY 



SYSTEM. PASCAL 



SYSTEM -LlfiRARY 



SYSTEM-CHAR5ET 



Cany diskeLte, any drive; default 
is boot diskette's vnrkfile 
SYSTEM -tfRK, CODE or .TEXT, any delve) 

(any diskette, aoy drive; required 
if host program is a textflle) 

{any diskette* any drive; optional; 

to fix errors found by Compiler) 
fboot dlskectei any drive; optional 

messages given on entering Editor] 

(any diskette, Ray drive; required) 

[boot diakectPi any drive; required 

to contain the needed routines} 

(boot diekette, boot drive; required 
between Compillngi Linking and 
executing steps) 

(boot diskette, boot drive; required 
if program uses long Integers, does 
file I/O using real numbers or SEEK.| 
nr USES Intrinsic Units) 

(any diskette, any drtvej required 
only if program uses WSTBING or 
UCHAE from TURTLEGRAPUICS) 



Any time Cbe Linker is Invoked, SYSTEM. LINKER must be available on any 
diskette in any disk drive- This file is normally fnund on diskette 
APPLE2: - When the LINKER prompt line appears, SYSTEM-LINKER is no longer 
necesaary, and tne diskette contalnlnp; SYSTEM-LINKER may he cemoved Eton 
the systeiD to make room for other diskettes- 

If you attempt t:i R(un a test workfile, first the Compiler Is invoked, 
which requires tuat the file SYSTEM -COMPILER be avnllable In any 
diskette in any disk drive- SYSTEM. COMPILER Is normally found on 
APPLE2: and also on APPLE0: - Then, folloving successful compilation, 
the Linker is called <lf linking is needed), using SYSTEM-LINKER - 
The Linker automatically tries to find any needed UNfTs or EXTERNAL 
routines by looking in the file SYSTEM- LIHRARV , which must be on the 
boot diskette (APPLEl: or APPLE0!) but may he Ln any disk drive- 
Finally, following successful compilation and linking the program is 
executed- if SYSTEM -LIBRARY Is required for enecution, it must be in 
the hoot drive on the boot diskette* 

Note: The system returns to the Command level for an Instant between 
any two portions of the R(un sequence. Therefore, you rrnist normally 
leave the boot diskette In the boot drive during the entire sequence- 
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If the workflle has already been compiled intfl ICH code versinn, Hlun 
win not call the Compiler, and SYSTEM. COM FILER Is not needed. If you 
invoke Che Linker by typing L , you can link raucines that are found 
in any available disk file. In that case, the file SYSTEHaiBRARY may 
not be needed* 

HulCl-dEive note: On foultlple-drlve systema, dtskette APPLEI; Is 
normally your boot diskette. If APPLEI: is in the hoot drive, and 
APPLE2! Is in a non-boot drive, your system will have available all 
the dlakfllea It needs Co EfdiC, C(ompile or A(BHemhle, LCtnk, K(ecute 
and Et.(un. 

Two-drive note! To L(ink when the host and library files are tiot 
already on APPLEI; or APPLEi: , you can use Che Filer to TCcansfer 
the needed files onto APPLE2: before linking. Alternatively, if the 
COMMAND prompt line Is showing, 1£ L(lnking is your only task, and if 
all your host and library files are on another diskette such as 
MYDISK: , you could put MVDISKj In the hoot drive and APPLE2: in the 
non-boot drive. When the linking process la complete. Che system will 
return to Che Coramand level. Since your booc diskette is noc the boot 
drive, you will be prompted to put ic In. 

One-drive note; To R{un a text UDckflle that needs linking to an 
external routine, you will have to use Che Filer to Tfransfer 
SYSTEM, LINKER Erom APPLE2: onto your boot diskette APPLE0: . With 
thlB version of APPLEB: In Che disk drive, your system will have 
available all the diskfllea it needs to E(dlt, C(omplle or A{sfieiQble, 
Lflnk, X(ecQte and Hun. Unfortunately, this will leave only 17 blocks 
free on APPLE0: for your text and code workllles, eCc. To roake more 
room on your booc diskette, you may wish to reniove the files 
SYSTEM. SVNTAX (use the compiler error inessagea shown tn the j^ple 
PaHcal Language Reference Manual. Instead), SYSTEM- CHARSET (only 
needed If your program uses WCHAB or WSTRING from TPRTLEGRAPHICS ) , and 
even SYSTEM. FILER (can be read In from any dlakecte, hb long as that 
diskette Is in the drive when yon invoke the Filer). 



E ^ 



USING THE LINKER 



There are two different ways to Invoke the Linker: by typing L for 
L(fnk or by typing R for R(un, both from the outermoat Command level 

of Pascal. 

If the Pascal program in the current text workflle contains EXTERNAL 
declarations, or USES UNITs which are not INTRINSIC tTNITs, typing R 
for R{un from the outermost Cofoniand level automaClcally Invokes Che 
Linker after cho Compiler, The Linker automatieally uses as ica boat 
file the code file where Che Cooipllec saved the code that resulted 
from a successful compilation (even If that file Is not the code 
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El ^ 



workflle SYSTEM, WRK. CODE). When Invoked by the R(un command, the 
Linker automatically Hearches the file SYSTEM. LIBRARY, which must be 
on Che boot diskette, for the roucinea or UNlTa specified, and linka 
chem into the workfile. If the UNIT or EKTERNALly declared routine Is 
not presenC in SYSTEM. LIBRARY, the Linker will respond with an 
appropriate messaae: 

UNIT, 
PHOC, 

FUNC, 
GLOBAL, 
or PUBLIC <ldentifler> UNDEFINED 

TYPE <Sf:*(CONTINUE), <ESC> (TERMINATE) 

You csn press Che spacehar, and the Linker will proceed. Crying to 
link whatever routines or UNITs are available In SYSTEM. LIBEIARY , 
Later, you can use the linker explicitly to link in the remaining 
routines or UNHs. If Che file SYSTEM- L LB RARY is not available on Che 
bone diakette, this nesssne appsarai 

NO FILE ^SYSTEM- LIBRARY 

TYPE <SF>fCONTlNl]E), <ESC>f TERMINATE) 

If Che Linker ffiils Co find a file with the enact filename specified 
at any point and that fllenarae does not end In -CODE or in .LIBRARY, 
Ic Chen adds the suffix -CODE to the fllenarae, and tries a^aln. In 
thlB case. Its own internal specification told It to look for 
*SYSTEM.LIBEARY . After this message, the Linker does not allow you 
to specify a diiferenC library file for your routine or UNIT, so there 
Is little point In continulnE- Just press the ESC key to pa hack Co 
Command level- 



The Linker may algo be Invoked E^^ipIIcltly, and. In facC. muaC be 
Invoked expliclEly in cases wliere 

(1) Che host file Into which UNITs or EXTERNAL routines are to 
he linked la noc Che code file resultina from a successful 
corapilation initiated by Che RCun corrimand, or 

(2) the tNITa or EJCTERNAL routines to he linked reside In 
filet other than the boot diakeCte's SYSTQ^, LIBRARY » 

In order to invoke Che Linker explicitly, you type L for Ulnk at the 
Command level fl,rd receive the prompt: 

LINKING... 



LINKER II. I FA4] 
HOST FILE? 



UNKER m 



The hoHCfne Is usually che Pascal ptogran codefile Into which the 
pxternal routines or UNITh are to be linked, (Id llnklnE between two 
aBBemblv routines, the hoscflle Is the routine which uaed .REF to 
declare certain labels as excernal.J 

If you just oreEH the RETURN key In responae to Che prompt, the Linker 
uses the boot dleketCe's workfile SYSTEM -WRK, CODE as the hostflle- If 
Che R(un coDnnand has juEt caused the GoDipller to save a cumpilled 
codeflle, that file Is taken aa the hoatfile even If It Is not 
SYSTEM. WHK, CODE - You may also respond by typing chD file 
apeclflcatlon of any other host codeflle- If the Linker cannot find a 
file with the exact filename you typed and Chat filename does noc end 
In -CODE or in -LlflRMV, it adds the auffij; .CODE to the fllenaine and 
tries again. Far this reason, if you reepond by typing the non- 
eltlatenl: filename 

MYDISK;WYF ILE, CODE 

the Llnleer returns the messaae 

NO FILE MYDISK.-HYFILE.CODE 

The Linker always displays Che full name of the last file It tried to 
open. 

The Linker then asks for Che name of the first library file in which 
the needed Pascal nNITs or EXTERNAL routines (or ,DEF asaeinbly 
subroutines) are to be found: 

LIB FILE 7 

You should respond by Cypln^ the file specif icatlon of any codeflle 
containing a Pascal [JNIT or E>n:ERI.'AL routine chat you want linked into 
the Pascal host proararn, fin llnkinn between two asaemhly routines, 
Che library file contains the routine ^ich used .DEF to declare 
certain labels as available for extemal use hy the host routine.) 

The Linker looks Elrat for the exact lllename that you type, and then 
(it the search was unsuccesuful ) adds the suffix -CODE and looks 
asaln. In any case, it always displays the name of the file flctuaUv 
opened. When the specified file has been found, you are Riven the same 
prompt again, askJiiK for the filename of another file contalnlUR a 
needed UNIT or routine. Up to el^ht library files may he referenced In 
one linkinB operation, TVplnK * (and then pressinji the RETURN key) 
In response to a request for a llbflle name will cause the Linker to 
reference SYSTEM. LIBRARY on the boot diskette. 



EXAMPLE: 



LIB FILE? * 

OPENING SYS rm- LIBRARY 
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For information on LIBRARIES and the LIBRARIAN see this manual's 
chapter UTILITY raOGRAMS* If a host codeflle or a library codeflle Is 
not of an appropriate type, the Apple will display an error message. 
These files must contain either compiled Pascal P-code or aBBeuibled 
650? asBembly cede. 

When all relevatit library files have been specified, answer the next 
LIB FILH? prompt by just pressing Che RETURN key to proceed. The 
Linker will now prompt with; 

MAP FIL£? 

If you respond by typing a file specification, Che Linker urltes a 
"mapfile'* to the file that you have Just specified- Note that the 
suffix -TEXT Is appended to the specified filename unless it already 
ends In ,TEXT or a period [ . ) is the last letter of the Ellenaiue. 
The mapflle contains relevant Linker Information regarding the llnklnfi 
process. Responding to this prompt by simply piessina the RETURN key 
causes no mapflle to be written. This la the response you will 
normally use. The iDapflle Is a diagnostic and Bysten programialng tool, 
and Is not required for moat uses of the Linker. 

Note: The output codeflle t-iee below) is opened with tile [0] filesi^e 
and Che inapflle Is opened AFTEW opening the output codeflle. If your 
system tries to put both files on the Bame diskette. It iDsy be unahle 
to open Che mapflle since the output codeflle may then occupy all the 
remaining diskette space. This does not stop the Linking process, but 
you will have no mapflle* You can solve this problem hy sending the 
mapflle to another diskette, Co COJJSOLE? , etc- 

The Linker now reads all segments required to start tbe linking 
process- Then you are prompted to type a file specif tcation for savlnE 
the linked code output: 

OUTPUT JTLET 

(this will often be the same filename as that of the host file, but 
you may not use the 5 same-name option offered by the Compiler and 
Assembler)- It is not neceasacy to add the suffix -CODE ; that suffii 
Is automatically supplied If yog don't type It- After the output file 
specification has been typed, press the KETURN key and linking will 
comnieucE- Responding with no filename (by pressing the RETURN key 
only) causes the linked output to be saved In the boot diskette's 
workflle, SYSTEM-WRK-CODE - 

Note: unless you specify a different flleslce, the output codeflle is 
opened with the [0] fllealEe- 

Durlng the linking proces,, the Linker will report on all segments 
being linked and on all external routines being copied Into the output 
codeflle. The linking process will be stopped If anv required 
segirentE or routines are missing or undefined- You will be told what 
vas missing, by messages as described at the beginning of this 
section, and allowed to terminate or continue the linking process. 
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INTRODUCTION 



In the Apple Pascal operating ayatem^ Che mage often used proarain 
portions can be selected from the varJaus prarapt lines. Other 
ptograPH, vrltten to accomplish lesa cnaiciDnly needed tasks, are 
available through the X(ecute command, and new features can be added 
to Che operating ayatem at any time in this way. Several of Apple 
Pascal's additions Co the operating syatejn, called Utility Programs, 
are described In this chapter- 

FORMAniNG NEW DISKEHES 



Before a new diskette (or one used in a syatEm other than Apple Pascal) 
can be used with the Apple Pascal syatem, it naist flrat be 
■formatted". This means that the diskette la erased, timing marks are 
recorded on the diskette for the system's reference, addresses are 
stored Co Identify each sector and block, and zeroea are stored In all 
data locations. Then, the diskette's bootstrap program is stored in 
blocks a and I (on the outerraoat Crack). Finally, a diskette directory 
Is written, and the diskette ie given the volume nanie BLANK; > 



DISKFILES NEEDED 

The followlna dlskflles allow you to use the diskette formatting 
utility program: 



FORMATTER. CODE 



FORMArrEP.TEXT 



Dlskettefs) to 
he Forpiatted 



(any dlakecce, any drive; required 
only to start) 

{any diskette, any drive; required 
only to start) 

tany drlve^ insert each diskette when 
prorapted, remove when prompted for 
next diskette to be formatted) 



The file FOHMATTEH»C0DE Is normally found an diskette AFPLE31 . When 
you terminate the formatting utility program, your boot diskette 
should be In the boot drive- I£ it ia not there, Che system will tell 
you to 

POT m AP?LE1: 

tlf APPLEl: is your boot diskette), 

One-drive note: Yau can start the diskette foriiatting utility by 
X(ecuting FORMATTER with APPLE3: in the drive. When the utility's 
first prompt line appears, you can then remove APPLE3: from the drive 
and put In the flrat diskette to be formatted. Do not remove the 
diskette being formatted until you are again prompted with 
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"FORMAT WHICH DISK?"* Put the boot diskette back in the drive before you 
quit Che utllltj program. 

Two-drive note: Vqu will normally place your boot diskette in the hoot 
drive and place AFPLE3: in the other drive to XCecute A]'PLE3:F0RMATTER . 
When the diskette formatting utility's first prompt line appears on 
Che screen, you can then remove APPLE3! from its drive and put In the 
first diskette co be formatted. 

USING THE UTILITY 

From the CorBPand level, with diskette APPLET: In any available drive, 
Lype X. for X(ecute- U^len you are prompted 

EXECUTE WHAT FILE? 

respond by typI^g 

APFLE31F0RMATTER 

<Note that you do not need to specify FORMATTER* CODE ; the -CODE BuffiK ii 
added automatically If you don't type it-) The system then 
execucefi FOilHATrEH.CODE, and displays the following roesaage: 

APPLE DISK FORMATTER PROGRAM 

FORMAT WHICH DISK (^, 5, 9..L2) ? 

You may now remnye diakeCte APPLE3: from Its drive, if you wish* Place 
in any availahls disk drive Che new or used diskette that you wish Co 
format. Then type the volume NUMBER at chaC disk drive- For eirariiple. 
If you put your new diakette in drive C5: , you should respond by typing 



and pressing the RETUIW key- First, the program checks the diskette 
CO be sure you are not accidentally ce-'formatting (and thereby 
erasing) a diskette previously formatted by the Apple Pascal system. 
If you forget and leave APPLE31 in the specified drive, for example, 
you will be warned by the question 

DESTROY DIRECTORT OF APPLE3 ? 
If you type N for No, you will again be asked ''FORMAT WHICH DTSK7"» 
If all goes well, the disk whirrs and clacks, and this message appears: 

NOW FORMATTING DISKETTE TN DRIVE 5 

When formatting la complete, you will be prompted to specify the next 
diskette to be formatted: 

FORMAT WHICH DISK. (4, 5, 9, .12) ? 

UTIUTV PROGRAM 185 



I 



Again, put In any drive Che ncKt dlgkette co be EoriMCted, and then 
Cype ChaC drive's volume number. 

When you hava formACted all the dlakettea you vJsh to Eormat. reapond 
to Che proiDpc 

FORMAT WHICH DISK (4, 5, 9.-12) ? 

by Juflt pceaaing Che RETURN key Co qulc the formatting pcogra™. Be sure 
Chac your booc diakeCCe is Jn Che booC drive before you quit Che 
focjEflctlng uCillcy progCM, or your sysCEm nay "liBng". (If that happens 
put your boat dJaketCe In Che boot drive end preaa the RESET key.) 

If the progran haa trouble forraactlng a diskette, this meaaage is 
displayed: 

ERHOH; UNABLE TO FORMAT DISK, 

DISKETTE WRITE PROTECTED, 
BAD MEDIA, OR HAD DRIVE- 

Check the obvloua qauBea, fluch as no dlakeCCe fn that drive, or 
improper JneerClon of the diekatCe, Dccaslonally, thia niesHflge is 
given when a uaed dlakeCCe le re-fonnatted- If you auapect Chat is 
Che only cause of trouble, Just Cry re-formaccina the diskette agaJn 
uncll the old Information Is coinpletely eraaed. 



1 li 



THE SYSTEM LIBRARIAN 



LIBBAJtY.CODE Is a utility program on diskette APPLE3; chat allows you 
to link aeparacely coioplled Paacal UNITg and separately compUed or 
afiaembled toucJnea into g library file. If ycjur Ubrary file is named 
SYSTEM. LIBRARY and la on the booc dlskecte, the R(un coimiand will 
automatically Link needed UNITb and external routines from your library 
into the program being R(un. UNITs which are labelled INTHlNSIC {see 
Che Apple Pascal Language Reference Manual) are found in your library 
and used without Linking. 

JJciSu ^^"" ^f"™™*^ '^oes not find a needed Item in Che boot diskette's 
SYSTEM. LIBRARY, you can either LCink Cho item In manually (see thia 
Dianiral'a chapter THE LINKERJ or you can puC the Item into a new booC 
diskette library file nacaed SYSTEM- LIBRARY . To add a new UNIT or 
routine to the booc dlakette'a SYSTEM- LIHHARV for Co deleCe one, or 
even juat to move one wlChln Che library), It is fJrflC necesaary to 
create a new, en^ty library file. Next, you must link each item that 
you want frocn the original SYSTEM- LIBRARY into Che new library file. 
You may then add new Items by linking from other codefiles into Che 
nev library file being created. In general, your new Ubrary file la 
not cceaced wlch the fllenane SYSTEM. LIBRARY . Sefore the syatem can 



t 
g 
1 

g 

g 

i 
i 

t 

i 



uae your new library file automatically, you must store your library 
on the boot diakette and name It SYSTEM. LIBRARY . 



DISKFILES NEEDED 

The follnwlog diakfilea allow you Co uae the librarian utility: 
LIBRARY. CODE 
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Link CodefiIe(s1 
containing UNITs 
and routineE to 
put in new Library 

Output Codefl Le Cor 
storing new library 



The file LIHRABY.CODE Is nor 
you (J(uit or A(bort the lihr 
should be in Che boot drive, 
tell you Co 

PUT IH APPLE 1: 



(If APPLEl! is your boot dlsketCeJ, 

One-drive note: On single-drive syateins, 
the Filer to TUanafer all necessary file 
X(acuClng LIBRARY. CODE . This is aafe be 
neceaaary file SYSTEM- PASCAL) la avallabl 
COMMAND level after using the librarian, 
librarian by XCecuClng APPLE3; LIBRARY wJt 
Che librarian's first prompt line appears 
in the drive. For one^drive use* the Out 
files must be on the same diakette. If c 
diskeCCe, put your boot diakette back int 
librarian utility program- 



tany diskette* any drive; required 
only to start) 

fany dlskeCCes, any drives; * apeclfiea 
booc diakecte'a SYSTEM. LIBRARY, any 
drivel each file must be available 
until next prompt for LINK CODE FILE) 

(any diskette, any drive; * specifies 
boot diskette's SYSTEM. LIBRARY, any 

drive; muat be available throughout) 



□ifllly found Qn diakette APFLE3: . When 
arian utility program, your booc diskette 
If It Is not there, the system will 



one approach is to use 
s onto your hoot diskette before 
cauae the hoot dlskeCCe (and che 
e when the system returns to 

However, you can stare Che 
h APPLEl: In the drive. When 
, you can put any other diskette 
put Code file and all Link Code 
hat diakette la not Che boot 
o che drive before you QCult Che 
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Two-drive ncite- ¥ou will normaily place your boot dlskccce Jn the boct 
drive, and place APPLE31 In the other drJye. When the utlUty'a flrgt 
proitpC line appears on the acceen, you can then recDDve AFFLE3: from Its 
drive and put in any other diakettea as needed- The diakecce 
containing the Output Cade tile lOUBt remain In Its drive throughout 
uss of the librarian utility- 

All note: l£ the Output Cade file's diskette Is removed from its drive 
while using the librarian, all displays will Indicate that the new 
library Is still being put together correctly. However, Che Indicated 
transfers of items from the Input Link Code files to the Output Code 
file are not actually carried out, even If the Output Code file's 
diskette la placed in a drive Just before (Jtultting the program^ 



EXAMPLE: INSTALLING A UNIT 
OR ROUTINE INTO A LIBRARY 

Suppose you wiah to create a new library file, called NEWiLISRARY , on 
dl&ketce l^VDlSK: . You want this new library file to contaJn all the 
items currently In the boot diskette's APPLEl : SYSTEM-LIBRARY , and you 
ulsh to add a regular UNIT or aaaeinbly-language routine called PILFEK 
from the file MYDISK: UPILFER,CODE, 

Une— drive note: If youra la a one-drive syatem, you ranat firat use the 

Filer to TCrenafer the file UPILFEK-CODE froa MYDISK: to your boot 

diskette APPLEl: , Then Q(ult the Filer- From here on, substitute 
APPLE!: uherever the example says MYDI5K: . 

From the Connnand level, with APPLE3: In any available disk drive, typo 
X for X(eciite. When you are prompted 

EXfiCUTK WHAT F1LE7 

Teapond by typing 

APPLE3: LIBRARY 
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(Note that you do not need to specify LIBRARY, CODE; the -CODE suffix 
supplied automatically.) The aysteoL then executes LIBRARY. CODE, 

and soon dlsplaya the measage 

PASCAL SY^TEH LIBHAHIAN 11.1 [BIJ 

At this point, you may remove APPLE3: from Its drive- Nex.c the 
program prompLB yoo for the name of an 

OUTPUT CODE FILE -> 



is 



uhich will becone your neu library file. For this exanqjle, with 
MYDISK: In Buy available drive, respond with the name 

MYDlSKiNEW.LIBKARY 

(Jne-dcive note: you should respond APPLEl: NEW.LIBRARY . 

Thla filename iB uaed exactly aa you type It; no eufflx la added by 
the syatem. The diskette containing the Output Code file must remain 

in Its drive throughout use of the librarian. 

The program now asks for the name oE a 
LINK CODE FILE -> 

which will provide the first source of UNlTs and routines to link into 
NEW. LIBRARY . The correct reapnnse here, wdth APPLEl: in any drive, is 

APPLEl :SYSTEH,L:flEAHY 

(Yoti can also type * to specify the hoot diskette's SYSTEM, LI BRAKY >) 

The screen next displays the "slot number", segment number {in parentheses! 
name, and length in bytes of each UNIT or routine currently in the Input 
Link Code File (right now, SYSTEM, LIBRARY) . There are a maximum of 16 
'^slots'', each coficainlng one code or data aegment, in any Apple Pascal 
program or library file. Note that an Intrinsic UNIT may occupy two 
9lotB» one for t^e code segment and one for the ciata segment* The number 
of bytes given fur an item la its length in the library. Thin length 
Includes the number of bytes the item will occupy when linked into your 
pcogrdm, plus a considerable number of bytes of Linker InEormatlon that 
la not placed In your program- 

The screen now Ijoks aQmethlng like this (you may, of course, have to 
use CTRL-A to ses the right half of the display): 
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SLOT lU LINK AMD <SPACE>, 
A < BURT 



FDR ALL, ? FOk SELECT, NCEW FILE, Q(UIT, 
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LINK 


CODE 


FILE -> APPLEliSYSTEM. LIBRARY 








iJ-paj LONGINTI 


2fi52 


8- 
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OUTPUT CODE FILE -> MYDISKi NEW. LI BRAKY 
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LENGTH - 1 
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Ydu now type the slot number, a number from through 15 taken from the 
leftnsDHt column of the Link Code File display, of an Item chat ynu wish 
placed In the nev library Elle- Then prega the tipacebar to terminate 
your entry. HeitC, when you are prampted 

SLOT TO LINK INTO? 



B 
E 



type the number of the slot which Che prevIouHly specified Item should 
occupy vheQ it is placed in the Output Code File <i.e- NEW^LIBtlARY) , And 
again, pfeaa the spacebar to ternilnflte your entry. At this tine, the k. 

tranafec of Che specified iCum la carried out- ^^ 

NUTE: you may abandoa your attempt to make a new library at any time, 
fllmply hy typing A for A(borC Inatead of a slot number. 



E- a 



For each itein placed in the new library file, the Librarian reads Chat 
Item from the specified slot of the Input Link Code File and stores It 
In the specified slot of the Output Code Kile. Items may be placed In 
any available library slot, In any order. After each Item Is 
traneferred, the librarian changes the display far the current state of 
the Output Code File, which Is your new library file. If you attempt 
to put two Input items Into one output slot, this message appearfl: 

WARNING - SLOT kx ALREADY LINKED. PLFj\SE RECDNFIHM (V/N) - 



If you type Y , the Icem previously placed 
replaced hy the Item currently being moved- 



En the specified slot will be 
Type N to abandon this move. 



Note tha: the old item is NOT removed from the library file you are inakii 
even though it no longer appears In any display of the file's contents. 
This extra code, which makes your new library file larger than It needs 
be, will disappear when you make another nev library from this one. 

To copy every Item from the old SYSTEM. LIBRARY Into your new library 
file, you may follow this sequence (press the spacebar to terminate each 
flntry): 



SLOT TO LINK INTO? (J 

I 

SLOT TO LIWK LNTO? I 

Z 

BLOT TO LINK INTO? 2 

3 

SLOT TO LIN^ INTO? 3 

SLOT TO LINK INTO? 4 

SLOT TO LINK INTO? 5 



i § 

E § 

E i 

i § 



E 
E 
E 

E 
E 
E-U 



Ur you may use one of the other options given In the prompt line* 
Type an equals sign £ ■ > to quickly copy every Item from Its slot In the 
input Link Cade 71 le into Che flame slot in the Output Code File- If you 
type a question ntarlt ( ? ) Che librarian will ask you about each Input 
item in turn^ 

COPY SLOT tf? 

Type Y if you wish the Item in slot to be copied into slot ff of your 
new library file, or type N If you do not vish to copy that item. When 
you are using the ■ or the 7 to copy items, each item copied from a slot 
in the input library will automatically be placed in the slot of the same 
number In your now output library. 

When all of the Itema that you want from this Input Link Code File 
have been copied into the Output Code File, a new Input file Is 
requested by typing N for N(ew file- You are again prompted for a 

LINK CODE FILE -> 

In this example, a separately con^lled regular Pascal UNIT called PILFER 
Is assumed to ealat in a codefile called UPILFEB.CODE , but the process 
would be identical if PILFER were a separately assembled machine- 
language procedure. 

Type the uflme of this new Input Link Code File: 

WYDISKeUPILFEH 

Ona-drlve note: You should type APPLEIfUPILFEB 

The librarian first looks on Che specified diskette for a file whose 
filenaoe Is e^acrily as you typed it. If there Is no file with that exact 
fllBiiame and thai filename does not end in .CODE , the suffix -CODE is 
added to the fllenaoie and the search is repeated. If the search la still 
unsuccesaful^ one of the folloving messages is dlaplayed- 
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I/O ERROR a la 
I/O ERROR 1/ 9 



tyour file was not found) 
lyour diskette was not found) 



In either case^ you are prompted to try again. The only way to escape 

the program at this point is by typing a correct file specification or 
by pressing the RETURN key and then typing A for A(bort. 
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When you correctly type the nflme of this new Unit Code File, the 
follovlng display appeam: 



LINK CODE FILE 


-> MYDISK 


UPILFEK.CODE 






0- 







fl- 


V 


1- 






9- 





2- 






l0-(25) PILyEK 


362 


3- 






11- 





4- 






12- 





5- 






13- 





6- 






U- 





1- 






15- 









In Chls example, the Unit PILFER occurs Jn UPILFER-GODE'h slot number 10 C 
and Jb to be liDked into alot number 7 (any unuaed slot Is equally good) 
wlChin NEW.LlBEtAHY . To acconqjllsh this, you should respond (preaalng 
the spacebar after each tesponae): B 

111 

SLOT TO LINK INTO? 7 



The final dleplay of the output library GegniBnt tahle 1b thus: 



OUTPUT CODE FILE -> HYDISK: NEW, LIBRARY 



CODE FILE LENGTH - 35 






0"t3aj LONCINTI 


2A52 


B 


l-On PASCALIO 


1238 
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2-(29J TRANSCEN 


libB 
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3-(22J APPLESTU 
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4-{28) TURTLEGR 


5282 
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5-f2U TURTLEGR 


3tib 


13 


6- 
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7-(25) PILFER 


362 


13 
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The new library's length in blocks la displayed and in this example is 39^ ^J 



Once the needed items from all Input Link Code Files havo been put 
into your new library's Output Code File, you lock the new Library bv 
typing q tor Q(uiC. This question appears at the bottom of the 
Screen: 

NOTICE? 

This gives you the chance to place a copyright notice In your library 
file. The ootlce will be displayed when a library inap Is produced for 
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youc file (aee the newt section of this chapterj» and provides an 
identifying lint- Vou might type 

COPYRIGHT 1979 APPLE COKFUTER AND ME 

for example (any neaGage, up to the ead of the current typing line). 

If you do not went a copyright in your library file, simply press the 
EtETURN key. When the COMMAND prompt line re-appears, your new library 
is complete' 



USING THE NEW LIBRARY 

Before you can uae your new library, the old SYSTEM. LIBRARY on yoUr 
boot diskette ahould be either removed or renamed. Then your new 
library file nwflt be T(ransf erreii onto your booE diskette, and its 
name Cthanged from NEW. LIBRARY to SYSTEM. LIBRARY . You should then 
I{nJtialiie the system ao EJiat the system will "learn" about the new 
library's contents and diskette position. 



SHORTHAND FILENAMES 

in response to :he Initial prompt "OUTPUT CODE FILE ->" ue couLd have 
JUQt aa easily said SYSTEM. LIBRARY followed by another SYSTEM. LIBRARY 
in reaponse to the prompt "LINK CODE FILE ->'\ If you do this, 
however, the original SYSTEM. LIBRARY will be removed automatically 
upon CDnqjLetion of the linking process. Typing Just * in reaponse 
to "OUTPUT CODE FILE ->" and again in response to "LINK CODE FILE ->" 
is an abbrevlacdd uay to indicate that the old SYSTEM. LIBRARY will 
simply be replaced by the new SYSTEM. LIBRARY . 

The system only "learns"' about the new material in SYSTEM. LIBRARY 
when Che eystem Is booted. If you apecifled SYSTEM. LIBRARY or ■ as 
the Output Code File, the mesaage 



PLEASE [IE-INITIALIZE SYSTEM 

appears after you respond to the NOTICE? prompt 
Apple's BESET key. 



Just pfesB the 
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UBRARY MAPPING 



The library mapping utility proBram prcducGa a map of a library file 
(or any codeflle) and llsCa the Linker Informaclon maintained for eacf 
aegjoent of the file* In the case uf aegments uhJch are Pascal UNITa 
the map file «lll alao contain the interface sectJcm of the UNIT, Se( 
this manual's chapter THE LINKER foe more information- See the Apple 
Pascal Languflge Reference Manual Eor greater derail about HNITb and 
linkage tP external routines- 



DISKFILES NEEDED 

The follawing dlakfiles allow you to uae Che library mapping utility 
prograia; 



f. 
E 

K 



LiaMAP.t;ODE 



Library Codeflleta) 
Co be loapped 



Map output tevtf I le 



<anj diskette, any drive; required B 

only Co start) 

{any diakettea. any drives; * apecJfie^ 
boot diskette's SYSTEM- LIBRARY, any ^ 
drive; each file muat be available 
until next prompt for LIBRARY NAME) 

■1 

(any diskette^ any drive, or sny other 
output device" default is CONSOLE: ; 
QUflC be available throughout! 



The Hie LlflHAP,CODE ia nonoHlly found on diskette ApPLE3r . When you 
tflcminate the library piapping utility program, your boot diskette 
should be In the hoot drive. It it ia not there, the syatera will tell 



you to 



i 



PUT IN APPLE 1 J 



(IE APPLEl: is your boot diskette^. 

One-drive note: On slngle-drivti gysteind, one approach Is to uae 
the Filer to TCtanafer all necessary files onto your hoot diskette 
before X(ecuting LIBMAP-CODE . This works well because Che boot dia 
(and the necessary file SYSTEM- PASCAL) ia available when you return 
COMMAND level after using the uclllCy* However, you can X(ecuto 
LIBMAP-CODE with APPLE3: in the drive. When the flfat prompt Une 
appears, you can put any other diskette in the drive. If you are 
storing the Map Output textfile on diskette, you must place all the 



kette 
to 



& 

ft 
t 
ft 



Hi 



Input Library codefiles on the same dlakette aa the Map Output 
teaCfile- If you specify the Map Output File Name aa PRINTER: or 
CONSOLE: you may put In the drive, one at a time, the diskettes 
containing the Input Library codefilea, leaving each diskette in the 
drive while Library fllea on that diskette are being mapped- Put 
the boot diakeCCe back in the drive before you quit the library 
mapping programn 

TwQ-drive note: You will normally place yout boot diskette in the boot 
drive, and placs APPLE3; in the other drive- When the utility's EirsC 
pron^t line app^aca on the screeEi, you can then remove APPLE3: from its 
drive and put Ja any other diskettes as needed- If you are storing 
the Hap Output tentfile on diskette, that diakette imiflt remain in its 
drWe throughout the mapping procedure- 



USING THE UTILITY 

With the COimAND prompt line ahouing, and with diskette APPLE3: in any 
available disk drive, type X far jC(ecute. When the prompt 

EXECUTE WHAT FILE? 

appears, respond by typing 

APPLE3:LlBrtAP 

(Note that you do not need to spei^lfy LIBMAP-CODE ; the suffix -CODE 
is supplied automatically IE you don't type It). Soon this message 
appears 

LIBRARY MAP UTaiTY II. 1 [A2I 

and Che prograa pronipta you to 

ENTEK LIBRARY NAME: 

When you reapor.d by typing an input Library (or any codefilej file 
specification, Che pro^^fair first attempts to find the file exactly as 
specified- If this search falls, the sufflu -CODE is added and the 
search ia made again. If the 5pecl£ii>d £1 lo or diakette i^ na[ found. 
this message appears: 

RAD FILE 

EKTEk LIBRARY NAME: 



Other ecrora give the message 

NOT A CODE FILE 

ESTBH LIBRARY NA*1E: 
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If you respond by aJnipiy typing an aatet^sk { * ), chla speclfiea the 
file SYSTEM-UIBRAJIY, on Che boot diskette ia any drive, as the innut 
Library file . *^ 

The library mappJng utility Is usually used to list library 
deflnlcioosi but the option Is also availably to include Linket 
inforuiaclon auch aa Intra-llbrary aymboJ references- Should thia 
feature be deaired, Cype a Y when queried 

LIST LIKKEB INFO TABLE (Y/NJ? 
If ycu respond by typing a Y , you will alno be aafced 

LIST REFEKENCEU LTEHS (V/HJ? 
A apace (or pressing the RETUitN key) Is considered an N , 
You are now prompted to specify a 

MAP OUTPUT FILE NAME; 

Note that If you don't add the aufflK .TJvXT to the filename, Che 
system automatically will add IC for you- To suspend thia sufflK- 
addlns feature, you rauac type an extra period after the fUenaniE, 
Responding hy pressing only Che RETUftH key senda Che map output to 
CONSOLE: , by default- 

Several librarlea may be mapped in flucceaslon. These lOflpa will all be 
aent to the same Hkp Output File npecified for the firat input Library 
file. 

Ta quit Che library napping ucillty, press Che RETURN key the neit 
CJnie you are prompted to 

ENTER LiaRAHY NAME: 

Be sure your boot diskette Is in the boot drive before you quit this 
utility. 
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EXAMPLE: MAP OF SYSTEM. LIBRARY 



LIBRARY MAP FOR APPLE0: SYSTEM. LIBRARY 
COPYftlGHT 1579 APPLE COMPUTER INC. 



Segment f3fl: 

System vertion = II. I, code type Is fi5fl2 

LONGlNTt library unit (LINKED INTBINSICJ 

TYPE DECHAX - 1NTECER136]; 

STUNT ■ RECORD CASE INTEGER Of 
2:(W2:tNTEGERl^])-, 
3: fW3:IWTEGER[8t)l 
A:CUA:INTEGER[12n 
5:(WS!lNT£GER[16J) 

ft: {U6:INTEGER[2fl]) 
7:(W7:1MTEGEB[24}) 
B!(W8;lKTEGER[2en 
9:(W9iEHTEGER[32i), 
10:<W10:INTEGER[36]} 
END; 

PEOCEDURE raEAULECtVAR F: FIB; VAR Dr STUNT; L; INTEGER); 
PROCEUUHE FUntTEDECtVAR. F: FIB; D: DECHAX; RLENG : INTEGER) 



Sei^eut S^i- 

System version ■ II-I, code type Is Undefined 

PASCALIO library unit (LINKED INTHDiSlC) 

PROCEDURE FSEEKtVAR F: FtB; HECNUM: INTEGER); 
PRUCRDURE FREADREAL(VAR F: FIB; VAR X: RKAL}; 
PROCEDURE FWRITEREALCVAR F: FID; K: KEAL; W, D: INTEGER) 
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Segraent 429: 

System version = II. I, code type is P-Code Cmost sig- 

TEANSCEN library unit fLINKED INTRINSIC) 

(S > 

FUNCTION SIN(X:REAL)!REAL; 

FUNCTION C0S{X:HEAL);REAL; 

FUNCTION EXP(X:REAL):REAL; 

FUNCTIOB ATANtXiREAL):REAL; 

FUNCTION LN(X:REAL)iREALi 

FUNCTIOK L0G(J!:HEAL);R£AL; 

FUNCTIOH SgRT(X:REAL):REAL; 



l3tj 
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SegEDBnC #22 r 

SyatEm version - IT, I, code type in 6502 
AFPLESTU library uniC (LINKED INTRINSIC) 
(S > 

FUNCTION PADDLE (SELECT: INTECER): INTEGER; 

FUNCTION BUTTON (SELECT! LNTEfiER): BOOLEAN; 

PROCEDURE rrLOUT( SELECT: INTEGER; DATA: BOOLEAN) 

FUNCTION KEYPRESS: BOOLEAN; 

FUNCTION RANDOM: INTEGER; 

PROCEDURE RANEOWIZE; 

PBOCEDURE NOTE (PITCH, CURAT ION: INTEGER); 



Syaten veraian «■ II. 1, code type la &502 
TURTLEGa ilbcary unlC CLINKEU INTRINSIC) 

TYPE 

SCR EENCOLOR- (none ,whl t e , b lack, rpverae , tadar , b lack 1 , 

green, V lolec , white I, bl-acki, orange, biiifi, whites J; 

PROCEDURE INITTURTLE; 
PROCEDURE TUHN(ANGLE: INTEGER); 
PROGEDlfRE TURNTOtANGLE: INTEGER); 

PROCEDURE MOVEtniSTi INTEGER); 

PROCEDURE [lOVETOtX.Y: INTEGER); 

PROCEDURE PEhCOLDR(PENMODEi SCREENCOLOR) ; 

PROCEDURE TEXTM0I3E; 

PROCEDURE CRAFMODE; 

PROCEDLfRE FILLSCREEN(FaLCOLOR: SCREENCOLQR) ; 

PROCEDURE VIEWP0RT{LErr,RIGHT,BOTTOH.TOP! INTEGER); 
FUNCTION TURTLEX: INTEGER; 
FUNCTION TURTLEY: ENTEGEH; 
FUNCTION TURTLEANC: INTEGER; 
FUNCTION SCREENBITCX.Y: INTEGER): BOOLEAN- 
PROCEDURE DHAWfiIX)CK(VAR SOURCE; EiOWSIZE.XSKlP,YSKTP,WlOTU .HEIGHT, 

XSCREEN,YSCREEN,MODE; INTEGER); 
PROCEDURE WCHAK(CH: CHAR); 
PROCEDURE WSTRINGtS: STRING); 
PROCEDURE CH ART YFE (MODE: INTEGER); 



E J 
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Segment ^21: 

Syateoi Version = II-l, code typo Is P-Code (least 3ig, lat) 

TURTLEGR data segment 
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SYSTEM RECONFIGURATION 

The Apple Pascal Operating System keeps certain Inforinaclon about the 
configuration of your gy^cem Jn a file calUd SYSTEM. HI SO INFO . 
During each systera initialization thia file ie cead into memory, and 
fcotn ther* It is used hy many parts of Che flyetem, particularly by the 
Editor. 

SYSTEM-MISCINFO comes already aet up to work doccectly with your 
Appie'9 keyboard and its TV or oionltor display, and you can operate 
the system without ever having Co study this section of Che manual- 

In addition, the language syateiii diskette APPLE3: contains a file 
named SOROCMISCINFO » which contains the conf Igurstion information 
neceasary to rita the Apple Pascal system with a Soroc IQIZ0 e^tternal 
terminal, and another f J Le named HAZEL -MISCINFO . which eonCalns the 
conflfiuration Information for a Haaeltine 1500 external termlnaK To 
use either of those tefjoinals, it is only necessary to rename the old 
SYSTEM. MlSCINFOt and then change the name of either SOROC- M ISC INFO or 
EUZEL.MISCINFO (the One corresponding to your terminal) Co 
SYSTEM. MI SCrSFO . Finally, you must read the next aectlon of this 
chapter, CHANCING GOTOXY COMMUNICATION, which tells you how to bind a 
new GOTOXY routine Into SYSTEM, PASCAL - That section has a complete 
example Cor aettlng up the Apple tii uhc a SOROC iQUft terminal- 

You only need to read the rest of thts section If you are golnft Co use 
the Apple Pascal system with an extemsl terminal, and that external 
terminal is neither a Soroc IQ120 nor a nazeltlne 1500- 



DISKFILES NEEDED 

The folloulug (liakfiles allow you to use the system reconf i guraLinn 
uciliLy progran. 



SETUP.CODE 



Output codef ile, creates 

NEU-MISCINFO [I hlockj 



(any diskette, any drivei required Co 
start, and also required to be in 
saine drive any time the T(each 
command is selected) 

(bone diskette, any drive; optional) 



The file SETUP. CODE la normally found on diskette APFLB3: . All 
aystemfi will normally start the reconEiBurati on program by X(HCuClng 
APPLE3:SETUP with APPLE3: in any available disk drive. 



IMPORTANT: The T(eaching portion of this utility la a segment 
procedure overlay, which means the systeoi must re-accesa SETUP. CODE in 
its original diak location when you type T for T{each. If you 
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■elecc Che T^esch camnand, you uaat first be sure the diskette 
containing SETUP. CODE fusually APP1.E2:) ia still In the drive It 
occupied when SKTUP-GQDE was X(ecL.ced. If Jt la not there when you 
type T for Tfeach, the system may "hang", and may even cause damage 
to Che infarmatlon on other dlshetteg in tho gyscem. It la not 
neccBBary to keep APPLE3: in Its drive after you have cojiipleted the 
Tteach gequcnce, oc if you do not use the Tfeach comniand- 



When yau E{xlt the reconfiguration utiiJty pfograni, your t 
should be in the boot drive. U it la not there, the syat 

teil you 



boot diskette 
em wl 1 1 



PUT IN APPLE!; 
(IE APPLEi; la your boot dlakettej- 

One-drive note: You will normally put APPLET: In the dlak drive tn 
begin, and leave it there while changing the setup infocmatlDn. When 
you are ready to Q(nlt Che reconfiguration utility and do a Ddafc 
update, you can remove APPLE3: from the drive and put In your hoot 
diskette. Your boot diskette muat be in the drive If you do a D(lsk 
update, which creates the file NF-W-HISCINFO on the boot diakette- Put 
the boot diskette In the drive before you EJxlt the reconfiguration 
utility program- 

Two-drive note: You will normally place your bout diskette in the boot 

drive» and place APPLE3: in the other drive to begin. Ordinarily, you 

should leave these disks In their drlvea throughout the use of the 
recooflguratlon utlllcy. 

USING THE UTILITY 

tf you are going to use an external termlnfll, certain Inf ormacfon 
needs to be initially set up by you to conform Co your particular 
hardware conf Iguratfon or Co your taste or convenience. Host of this 
InformatiDn concerns the nature of your terminal and keyboard, 
although there are a few miscellaneous fields. 

The systecu reconfiguration utility Is run by entering the Cojomand 
level of the system and, with APPLES: In any available disk drive, 
typing X for Xlecute, When the prompt message 

EXECUTE WHAT FILE? 

appears, respond by typing the filenane 

APPLE3: SETUP 






5 
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(Note that you dc not need to specify SETUP-CODE ; the -CODE suffix Is 
automatically added to any filenarae you CypeO You should then see 
the following: 



INITIALIZING 

"sETUprCtHANGE T(EACH H£ELP QfUIT [S-Z] 

All commands Co the SETUP program are invoked by typing a single 
letter chosen from the pronipCline 

SETUP: C(HAMGE T{EACH UfELP IJtUlI 

Type H for Htelp in finding out what the comiaanda at this level do. 

Type T if you wlflh the program to T<eflch you how to une the 
ceconflsuration utility. This command tella you how to enter non- 
printing characters, how to avoid making a prompted change, how to 
delete a typing error, how Co change the default radix, and other 
useful information. 



^ 



IMPORTANT: If you type T for TCeach, you must first be sure Chat 
APPLE3: la stilL In the drive it occupied when APPLE3:SETUP.C0DE waa 
X(ecuted. If iL is not there, the system may "hang", and (oay even 
cause damage to the Information on other diskettes in Che system. IC 
is not necessary to keep APPLE3: In Its drive after you have compleCed 
Che T(each sequence, or if you do not use the T(each conmand- 

Type C If you wish to Cthange or examine the various items of the 
Hystem's information about your hardware configuration- You may 
either change a single item that you specify from Che LIST OF All- 
SETUP PARAMETERS taC the end of this section); or you nwy choose to 
have Che program step through all the parameters, letting you examine 
or change each one- The T{each command gives a full explanation of 
all of these options- 

Type Q when you wish Co make your configuration chflnges permanent 
and leave the reconf iguratlon prograiu. The reconfiguration utility's 
gCult command cfEers several options: 

D<lak update: creates the file NEW,MISC1NF0, on Che boot diskette 
in any drive. ThiH filename must lattr be changed to 
SYSTEM-HISCINFO before the new setup can be used by the 
syetem- No message Is given If the boot diskette is not 
found, but no file NEW,HISCINFQ is created- You are then 
returned to the Qfnit level of the reconfiguration program, 

M(eraory update: places Che definitions in memory, where they 
change the system setup until the next boot, RESET, or 
initialization. You are then returned to the Qfuil level 
of Che reconfiguration progcam. 
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E<Eturn: takps j^ou back ta the oialn prompt line of Che 

reconfiguration progrflm, In caae you are not done- 

fl(elp: ffxplfllns the q(uJC options, and then reCumG you Co the 
lj(ulc level of the reconf Jguracf on program. 

E<xlt: returns you to Ehe operating aystera's Coaimnnd level- 
Put your boot diskette back in the hoot drive before 
you type E . 

The operation of the reconfiguration utility is aelf Ceachlng (Juat 
type T for T£each fcora Che main SETUP prompt line), ao the rest of 
ChiB seetian explains the varioua JCeia of informflCion Chat this 
utility was designed Co change. 

EXTERNAL TERMINAL REQUIREMENTS 

By Uflina an Apple ComniinlcstionH Interface Card and an external cerminal 
such as the Soroe 1^120, it beconias possible Co do te^t and program 
edit flg In upper and lowtjr case characters, on a large (30 characters by 
^4 lines) screen. For [iiaxlimin effectiveness, the Edltur reouirea a 
reaaonahly powerful CRT cerminal «ith Che following feacurea: 

CLEAR TO END OF LINE 



CLEAR TO END OF SCREWS 



E 
E 
E 

E 
E 

i 



GOTOXy ADDRESSING 
NDFS 

LF 

HLF 



- gn directly to a given row and column on the screen |6 
non-descruccive forward space {the Inverse of hack- 



apace) 

down one line <and If at Che bottom of the acreen 
pcrolXa up) 

reverse line feed (up one Une; not required tci 
reverse scroll) 



The Soroc iqi2(*, DEC mz and Hazeltlne 1500 are exmiiplee of such 
Cermlnals. The main advantage of ualng an exCernal terminal with Che 
Apple Pascal systerr, is thaC ic can provide upper and lower case for 
text editing, and allows you to see the syaCen's entice eighty- k 

t^r^i^-r/^"^ ^1 °"? '^'"^' ^^'^ ""^^ P-^osramlng purposes, an external ■ 
cernijiial is compleCely unneceesary, 

acceas cursor addreealng on an external cermlnal (for those terminals 
vhlch have this capability). To allow the avfltem to use chat feaCure, 
please refer Co the nesc secCion, CHANGING GOTOXY COMMIWICATION. 

Note: A para™,eCer value of "NUL" (ASCII fl) uflually i«ans Che parameCer 
dnea not apply to the eysceni being see up, 
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MISCELLANEOUS INFORMATION 



tlAS CLOCK 



Value: TRUE or FALSE 



Will be FALSE for che Apple* No provision has been lodde for 
operation uich accessory real-time clocks ■ 



STCfiJENT 



Valuer TRUE or FALSE 



If true, tells the systera Co simplify certain pares of the sysCera 
for novice use. E.g., an error detected while cornplllng sends 
student back to the Editor vlChouc choice. 



■^ HAS B5lflA Value: THUE or FALSE 

This is alwaya FALSE on an Apple- 



i 



HAS BYTE FLIPPED MACHINE 



Muse he FALSE for the Apple. 



Value: TRUE or FALSE 



3 GENERAL 



TERMINAL INFORMATION 



1 § 



HAS SLOW TERMINAL 



Valuei TRtJE or FALSE- 



i ^ 



When this field fa true, the sysCem lasues abbreviated promptllnef 
and loeaaagps. Suggescod setting: 600 baud and under ~ True, 
otherwiae False. This is normally FALSE an the Apple. 



i i 



HAS RANDOM CURSOR ADDRESSING 



Value: TRDE or FALSE 



Only applioH [o video terralnals. See Section 4.7 in order to 
allow Che syacem to make use of this feature. On the Apple 
this field ia TRDE. 



HAS LOWER CASE 



Vaiue: TRUE or FALSE 



This Is noniifllly FALSE Eor an Apple, although It uiay be Crue If 
ynu have an external cerminal wJCh lower case- 
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SCREEN b/IDTU 



Value: The nuaier of characterfl 
per line of .1 terminal. 



For Hoat cisternal terminals, Chla should be B0, For the Apple 
with no external CermlQal, setting a value of 79 allowa alnoat all 
of the system's flS-character wlndov to be viewed {with Che help of 
GTRL-A] , while causing some proinpt lines to be displayed In a 
shortened forn that Is herter suited to a Afl-character screen- 



t 



SCREEN HEICIHT 



Value: The number of Lines per display 
screen of a vfdeo Cezmlnel- 



Set to for a hard copy terminal or other terminal in which 
paging iH not appropriate. Some termlnala may require you to set 
the screen to one more than the number of available screen lines 
to insure proper Herolllng, This Is aet to 2A Cor the Apple. 



NOfJPHINTiUJt; CHARACTER 



Value: Any printing character* 



Specifies what should be displayed by the terminal to Indicate the 
presence of a non-prJntlng character- Recommended sectlng: ASCII 7 



VERTICAL HOVE DELAY 



Value: The number of nulls to send 

after a vertical cursor move. 



Heny types of terminals require a del^y after certain cutaot 
movements which enables the terminal to complete the ncvement 
before the next character Is sent. This namhor of nulls will be 
sent after carriage returns, EBASR TO END OF LINE, EHASE TO DJD OF 
SCREEN and MOVE CimSOR OP- This number is 9 on the Apple- 



CONTROL KEY INFORMATION 

Vou may choose which control keys suit your particular keyboard 
arrangement and your taste. Again, this aecclon has already been set 
up for your Apple- 

SoEOQ keyboards generate two codes when certain single keys are 
pressed' If that Is the case for any of the keys nentlontid here. It 
must bo noted In the field PREFIXED {<f leldname>] vhlch has either the 
value TRUE or the value FALSE, The preflu for all such keys must be 
the same and must be noted in the field LEAD IN FHOM KEYBOARD. This 
feature may also be used to acceae control functions with two- 
character sei^uences if your keyboard Is unable to generate uiflny 
control characters- As an example, suppose your keyboard had a vector 
pad which generated the value pairs ESC-U , ESC-D , ESC-L and ESC-R 
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for the keys for Up-arrow, Down-arrow, Left-arrow and Hlght-aTTOW. 

respectively. Aflsuine also that all other keys on the keyboard 

generate only single codes. Then the user would give the following 
flelda the following values: 



KEY FOB MOVING CURSOR UP 
KEY FOR MOVING CURSOR DOWN 
KEY FOR MOVING CURSOR LEFT 
KEY FOR MOVING CURSOR RIGHT 
LEAL IW FTiOM KEYBOARD 
PBEFlXED[tXY FOR MOVING CURSOR UP] 
PREFIXED [KEY FOR MOVING CURSOR DOWNl 
PREFIXED ItLEY FOR MOVING CURSOR LEFTJ 



ASCII 


U 


Ascx: 


D 


ASCII 


L 


ASCII 


R 


ESC 




TRUE 




TRUE 




TRUE 




TRUE 





PREFIXEDfEEY FOR MOVING CURSOR RIGHTJ 



KEY FOR STOP 

Console output stop character- The STOP character Is a toggle; when 
pressed, the key will cause output to the file 'OUTPUT' to cease* 
When the key is depressed again, the write to file 'OUTPUT' will 
refiucie where It left off* This function ia very useful for reading 
data which la being displayed Easter than one can read> Suggested 
setting: CTHL-S 



KEY FOR FLUSH 

Conaole output cancel character. Similar In roneept and usage to the 

STOP key, the FLUSH key will cause output to the file 'OUTPUT' to go 
undlsplayed until FLUSH is pressed again or the syateiD writes to file 

'KEYBOARD'. Note that, unlike the STOP key, processing continues 

uninterrupted whi le output goes undisplayed- Suggested setting: 
CTHL-F 



KEY FOR BREAK 

Typlnji the cherscter BREAK wl II Cfluse the prograra currently executing to 

be terminated with a run-Cliae error I jmaed lately. Suggested setting: 

SDiaethlng difficult to hlC accidentally. This Is set to ASCII fl on the 
Apple which, In this case, represents CTRL-@ , 



•J3 KEY TO END FILE 

3 



Console end of file character- When reading frura the files KEYBOARD 
or IKPUT or the unit CONSOLE: , thl*i key sets Che Boolean function EOF 
to TRUE. See the description of the EOF intrinsic In the Apple Paacal 
Lenfiuage Referer.ce Manual. Suggested setting: ASCII ETX (CTRL-C) 



UTIUTV PROGRAM 505 



JtEY TO DELETE CHARACTER 

Each Cine you pr^aa thia key one charatCer la removed Eroin the current 
line, until nothing la left on that line. Suggeated setting: ASCII HS 
tleft-artow key, or CTBL-H) 



I 



EDITOR "ACCEPT" KET 

The key vhlch, in Che ayatem acreen oriented editor, la to be used to 
accept coramandEiH making pecmanent any action taken- Suggeated 
BetClng; ASOll ETX (CTRL-CJ. 



KEY -til DELETE LINE 

DepresBlng LINE DELETE will cause the enrrent line of input to be 
erased. SuBgeated aettlngi CIRL-X 



The rest of this 9ei:Cian contalnG Information 
only of interest Co naers who are using video 
display E^nDinala with a selective eraae 
capability and juay be safely ignored by users 
having any other kind of terminal, such aa 
hardcopy termlnflla or storage tube teTmlnala* 



KEV TO MOVE CURSOR UP 

KEY TO MOVE CURSOR DOWN 

KEY TO HOVE CURSOR LEFf 

KEY TO HOVE CURSOR RIGHT 

Theae keys are used by the acreen oriented editor to control Che basic 
iLJotiana of the cursor- If the keyboard baa a vector pad, aet these 
fields to the values iL generates* OthetwiBe, we suggest that you 
chouse four keyboard keys which lie in the pattern o£ a vector pad, 
end use the control codes which correspond to then- For example, Che 
keys 0', 't'l 'K' and ';' on moat keyboards encircle an imaginary 
vector pad- You may wish to uae a prefix character before such keva 
as described above* 

On Che Apple, of course, the right-arrow and left-arroti keya serve 
for right and left curaor motion- ■Because of their vertical 

orientation, CTtiL-O and CTRL-L have been chosen for up and down motion 
of the cursor- 



EDITOR "ESCAPE" KET 

The key which, in the system acreen oriented edltoCt is to be used to 
escape froin coumanda, reverainfl any action taken- "iuggeated aetCing: 
ESC 



E 
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VIDEO SCREEN CONTROL CHARACTERS 

This section deacribes the chacactera which, when aenC to the terminal 
by the computer, control the terminal's actlona. Ynu ahould consult 
the manual for your terminal cc find the appropriate values- If a 
terminal does not have one of these characters, the field ahould be 
set to Q unless otherwise directed' 

Some screens require a two-character sequence to exerclae aone □£ 
their functions^ If the flrat character in all of theSE! sequences Is 
the aame, it can be aet as the value of the field LEAD IN 10 SCREEN 
and for each <fleldnaiiie> which requirea that prefix, the user muaC set 
Che field PREFIX [<fleldnsrie>] to TRUE, For example, aupposo ERASE TO 
END OF LINE and ERASE TO END OF SCREEN were reapectively performed by 
Che sequences ESC-L and ESC-S but all the other acreen controls 
were slnflle chatacters. The user would Chen set Che following fields 
to the following values: 

lead in to screen ascii esc 

erase to end of line ascii l 

erase to end of screen ascii 5 

prefi):ed[ekase to end of screen] true 

prefiied [erase to end of line] true 



ERASE TO END OF SCREEN 

The character which erases Che acreen from the current curaor position 

to Che end of Che screen- 



ERASE TO END OF LINE 

The character which, when aent to the screen, erases all characters 
from the current cursor poaician to the end of the line Che cursor li 
on- 



3 ERASE LINE 

_ The characcer which, when sent Co Che acreen, eraaea all the 
0^ characters on Che line the cursor Is currently on. 
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ERASE SCREEN 

The chacacter t^ch, uhea senc to the scr^ea, eisEeo the entire 



HACKS PACE 

The character which, when sent Co the iicireeD, cauHGs the cursor 
tn move one apace to the lelc 



MOVE CUHSOB HOME 

The character which movea your cursor to the upper left of the current 
page. II'IPURTANT: C£ your terodnal does not have such a character, 
set this field to CARRIAGE RETURN, ASCII mneinonlc CR. 



flOVE CURSOR UP 
MUVE CURSOR RIGHT 

The characters which nuve your cursor non-deHtructively One Space In 
those directions^ 



LIST OF ALL SETUP PARAMETERS 



Parameter 
Field Name 



Default value for SYSTEM-MISCINFO 
on APPLEfl: or APPLEI; 



r' 31 
r 3 

t i 

I i 

i 3 

E 3 



BACKSPACE 

EUITUR ACCEPT KEY 

EDITOR ESCAPE KE^f 

ERASt: LINE 

ERASE SCREEN 

ERASE 71) END OF LINE 

ERASE TO END OF SCREEN 

HAS 8311JA 

HAS UYTE aiFPED HACKIHE 

UAS CLOCK 

HAS LOWER CASE 

HAS R^SDOM CURSOR ADDRESSING 

HAS SLOW TERMUJAL 

KEY FUK BREAK 

KEY POH FLUSH 

KEY EUR STOP 

KEY TO DELETE CltAKACTER 

KEY TU DELETE LINE 
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left -arrow 

CTRL-C 

ESC 


key 


(CTRL-H) 


E 


§ 


NDL 

CTRL-L 

CTRL-] 

CTRL-R 

FALSE 

FALSE 

FALSE 

FALSE 




CASCII 9) 




3 
3 


TRUE 










FALSE 

«irL 

CTRL-F 




(ASCII 9) 


I-- 


.^ 


LTRL-S 
lef t-srroH 
CTRL-X 


key 


(CTHL-H) 




3 
3 



KEY TO EMD FILE 

KEY TO MOVE CURSOR DOWM 

KEY TO MOVE CURSOR LEFT 

KEY TO MOVE CURSOR RIGHT 

KEY TO MOVE CURSOR UP 

LEAD IN FROM KEYBOARD 

LEAD IN TO SCREEN 

HOVE CURSOR HOHE 

HOVE CURSOR RlCtlT 

HOVE CURSOR UP 

NON PRINTING CHARACTER 

PREFLKED {DELETE CHARACTER] 

PKEPIKED JEDITOa ACCEPT KEY] 

PKLFIXED jEDiroJL ESCAPE KEY] 

PREFIXED [ERASE LINE] 

PREFIXED [ERASE SCREEN] 

PREFIXED [ERASE TO END OP LINE] 

PREFIXED [ERASE TO END OF SCREEN] 

PREFIXED [KEY FOR BREAK] 

PREFIXED IKZY FOR FLUSHj 

PREFIXED [KEV TO WOVE CURSOR DOWN] 

PREFIXED [KEY TO HOVE CURSOR LEFT] 

PREFIXED iKEY TD MOVE CUR^^OR RIGHT] 

PREFIKEL IKEY TO MOVE CURSOR UP] 

PREFIXED [KEY FOR STOP] 

PREFIXED iKEY TO DELETE CHARACTER] 

PREFIXED [KEY TO DELETE LIME] 

PREFIXED [KEY TO E«D FILE] 

PREFIXED [MOVE CURSOR HOME] 

PREFIXED (MOVE CURSOR BIGHT] 

PREFIXED [HOVE CURSOR UP] 

PREFIXED [NON PRINTINC CHARACTER] 

SCREEN HEIGHT 

SCREEN WIDTH 

STUDENT 

VERTICAL MOVE DELAY 



CTRL-C 

CTRL-L 

left-arrow key (CTRL-H) 

right-arrow key (CTRL-U) 

CTRL-0 



KDL 
VUL 
CTRL-Y 
CrRL-\ 

CTRL-_ 

7 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

FALSE 

2if 

79 

FALSE 



(ASCII 0) 
(ASCII 0) 
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CHANGING GOTOXY COMMUNICATION 

The GOTOXY procedure, which allows the Apple Pascal Dpecfltlng ayatem Co 
corncnunlcatf* with the video ecceen, ia already set up correctly foe the 
App*e, GOTOKY la included In Che syatem aa one of Che incrinsic 
pcoceduCEB In the Apple Pascal language. See the Apple Pflacal Language 
Reference Manual for more detallH about the InCrlnalc GOTOXY . This 
portion of Cht! inanual la only presented for your reference, as you will 
not normally need tcj change the GOTOXY procedure unless you want to uae 
an external terminal . 

If you are going Co uae an external terminal, you should ilrac read Che 
previous eecclon of this chapter, SYSTEM RECONFIGURATION, then follow 
Che directions given there for creating a new boat diskette file 
SYSTEM.MISCINFO - 



r 



The proaram BrWDER-CODE on dlskeCCe APPLE^i alcers Che file SYSTEM. PASCAL 
on Che hoot diskette. You are prompted to provide ^'GOTOXY", a procedure ^ 
which must be created and bound Into the syaCem (only once) In order to H 
make the system communicate correctly with your PKCernal terminal's acroen. 



On diskeCCe APPLE3: there are ejiamplea of Pascal GOTOXY procedures 
already written for two of the more popular eKternal terminals. The 
file SOBOCOOTO contains the correct GOTOXY procedure for Che Soroc 
HJ120, and the file EIAZELGOTO contatna a GOTOXY for the Hazolclne 
1500, Theae procedures have already been compiled Into their -CODE 
vecaiona, but the ,TEXT veceions have been included alsn, Co give you 
mode} i-rfilch can be modified for use with other terminals- 

If Che GOTOXY curaor-ad dressing procedure for your terminal Ih not 
already on APPLE3: > you must create one (by modifying SOROCGOTO-TEXT) 
and compile it. The procedure may WDT be naraed GOTOXY. 



The GOTOXY procedure sendg the cursor to a point on the screen 
determined by a specified pair of cnordlnates (KCOORD,YCUOR!l) . 
procedure aasumes the following: 



The 



I. A video acreen terminal 

2» An Apple Pascal System 

3- The upper left-hand corner of the screen is X^O, Y=B 

A. GOTOXY corrects for bad input data: X-coordlnates rauaC 
be limlCed Co Che nurabqr of characters per line 
(Integers in Che range through 79 for a SOROC iql20); 
Y-coordinates must be limited Co Che number of linea 
per screen (integers in the range (I through 23 for a 
SOROG IQ120), 

In writing your own Pascal GOTOXY procedure, here are two common ercon 

Possible error; PosBlhle cure: 



■ 3 

E 3 

i 3 

t 3 



Nil Dtemory reference 
at compile time 

Value range error 

when executing BINDER 
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Remove the program heading 

and try again 

<*Stl-*) ahould be the first 
tting In the GOTOXY file 



i^Ji 



DISKFILf S NEEDED 

The following dlskfllea allow you to use the utility for changing 
GOTOXY communication with Che acreeo. 



BINDER. CODE 



SYSTEM. PASCAL 



Co defile containing 
new GOTOXY procedure 



Output codefllst creates 
NPW. PASCAL [36 blockel 



(any diskette, any driven required 
only Co stare) 

(booC diskette, any drive; required 

to ptart) 

{aay diskette, any drive; required 
throughout; for SOROC LQl2tf use 

SOROCGOTO.CODE; for Haaelcine 
1500 uae HAZELGOTO.CODE) 

(boot diskeCCe, any dirlve; required 
tliroughouC; can later bo used to 

replace SYSTEM. PASCAL) 



The file BINDER. COPE is normally found on dlaketce APPLE3: , When the 

utility for changing GOTOXY comnunlcation terminates, vour booC 

diakeCCe should be in Che booC drive- If it ia not there, the 
system will tell you 

PITT IM APPLE 1: 

(if APPLE!: la your boot diskette). 

One-drive note: First, uae the Filer to T(ranfl£er APPLE3: BINDER. CODE 
and the file cortaining your new CQTOXY procedure (for a SOROC Igi2fl, 
thia would be Af PLE3: SOROCGGTO.CUDE) onto your boot diskette. You are 
then ready to X(ecute BINPEH with your boot diskette in Che drive. 

Two-drive noCe: You will notraally place your boot dlakette in Che booC 
delve, and place APPLE3: in the ocher drive. You are then ready to 
X(ecuta APPLE3!E1ND£R , 

EXAMPLE: SETUP FOR SOROC IQ120 

You are about tc create a naw boot dlskeCte, ao you should first make 
a copy of the current boot dlakeCte APPLEl: . 

Now, from the Coomand level, with all the neceaaary files In tlie 
available disk drives, type X foe X(ecuCe. Answer Che queation 

EXECUTE WHAT FILE? 

by typing the file naine 

APPLE3:BIPJDE|l 
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One-drive note: You have TCranaferred BIKDEE-CODE to your baoc 
dlBkettet APPLEl: . Vou shauld type 

APPLElrBlNUER 

(Note Chat It la nnt necessary to apeciEy BINBER.CODE j the -CODE suffli 
is automatically added if /ou doc't type It). The screen will 
Hoon shQw this ticls! 

APPLE GOTQXT BINDER 

The program now Looka for the old Elle SYSTEM. PASCAL, which rauat be on 
your boot diakecte in any drive, l£ you eee thia nEss^ge 

ERROR: NO FILE SYSTEM- PASCAL 
PJiESS SPACE TO CONTINUE 

your boot diskette was probably noC In any drive. You should put your 
boot diskette in the boot drive and press the Apple's spacebar to 
return to Command level- Then you can try to X{ecute the proRram 
again- 

Uhen the progracq has succeeafuLly fouod the boot diskette file 
SYSTEM. PASCAL , It pronpta you to HpeclEy the 

FILE WHICH CONTAINS GOTOXY? 

For this exsFTiple» you should respond by typing 

APPLE 3: SOROCGDTO 

{for a different tennlnfll, this would be the new COTOXY procedure you 
compiled after modifying SOROCCOTO-TEXT for your ternlnal). The 
program looks first for a file whoae filename Is exactly as you typed 
It- If chat search is not succesaful, the suffix -CODE Is added to 
the filename and the search Is made again. When your file is found, 
the disks whirr, and loessagcs appear eaylng 



5J 



COPYING 
COPYING 
COPYING 
COPYING 
COPYING 
COPYING 
COPYIhJG 



SEGMENT 15 
SEGMENT 
SEGMENT 1 
SEGMENT 2 
SEGMENT 3 
SEGMENT 4 
SEGMENT 5 



r ^ 


B- 


[j 


1 


2 


■ 


^ 


IT 


3 


■^ -^ 


i^-a 


fit 


^ 



and so on. When the COMMAND prompt line reappearSi the copy of 
AFPLEh has the new file NEW, PASCAL on it. This file is the old 
SYSTEM, PASCAL with the new COTOXY procedure for your terminal bound 
into it- Before the syatem can use this new file, the old file 



b2 ^ 



SYS TKfl* PASCAL niuac be removed frotn cho disk (or at least renamed) and 

NEW. PASCAL must he given Che name SYSTEM, PASCAL . To do this ail at 

once, type F lo enter the Filer, and then type T for T(ran3fer. 
The following dialog will then do the Job: 

IKANSFER? NEW. PASCAL 
TO WtiERET SYSTEM. PASCAL[36J 
REMOVE OLD APPLEI :SYST£M. PASCAL ? Y 
APPLE I ; NEW . PASCAL 
^> APPLE1:SYSTEM, PASCAL 

(Rcinembec that ihe Apple producea [ by typing CTRL-K, and J by 
typing SHIFT-M *) A copy of NEW-FASCAL has now replaced the old 
SYSTEM. PASCAL and chat copy was tenamed at tbe same time to 
SYSTEM. PASCAL - 

Vou can now R(eiiiove the original file NEW. PASCAL from the boot 
diskette. Finally, to avoid confusion, C(hange the name of this new 
hoot diskette from APPLEL: to SOROC 1 : and label the diskette with this 
name. 

At this time, yau should also replace the file SYSTEM^MISCINFO on 
SOBOCl! with tbe file called APPLE3:S0R0C.MISC1NF0 (for a different 
terminal, this muld he the NEW.MISClNFO you generated with the SETUP 
program, described In the previous section of this chapter, SYSTEM 
RECONFIGURATION)- This dialog will do It all at once: 

TRANSFER? AFFLR3:S0R0C,MISCINF0 
TO WHERE? SOROCI:SYSTEH.MISGINF011J 
REMOVE OLD SOROCi! SYSTEM. WISCINFO ? V 
APPLES : SOBOC . MISCl fJPO 
— > S0R0C1:SYSTEM-KISCINF0 

Note: the information you have Just changed In making SOROCl: will not 
affect the system until you reboot the system with SOROGl: in Che boot 
dlHk drive. 



212 APPLE PASCAL OPEf?ATlNG SYSTEM 



^^ 



LUlLfTY PfSOGRAM 213 



REMOVING LINEFEED FROM RETURN 



Various printers used with the Apple Psscsl sysceni have different 
requIrenpntH for deallnfi with &ETUHK (carriage ceturn, or ASCII CR) 
chflcacters- Sotoe printers requite chat a linefeed character follcsw 
every [lETURN character, while other printers automacically supply 
their own llneff^ed following every RETURN charai^Eer. 

The file whith dontninE the system's hardware conf iguratlnn 
infonnatlon, SYSTtH-HTSCINFO, does not have any infonnQtion about the 
printer's requirementa . The ^ple pascal ByEtem normally gpnda out e 
linefeed after every RETURN character. This matches the requirements 
of nsoflt printers. However, on soine printers this may cause double 
spacing between Lines, and some printers arc unable to work properly 
if sent these KETURN+lineEe^d combinations. For printers that do not 
work properly when aent a linefeed after every RETURN character, the 
Apple Pascal syatem provides the Linefeed utility program. 



DISKFILES NEEDED 

The fQllowlnB diskflle allows you to use the utiiity program for 
preventing a linefeed from being sent to the printer after every 
RETURN character- 



LINEFEEC-CODE 



(any diskette, any drive; required 
only tn starts changes memory only, 
no change to any permanent file) 



The file LINEFEED. CODE is normally found on diskette APPLe3: . When 
the Linefeed utility prograni cermlnateH, your boot diskette should be 
In the boot drive. If it is not there, the system will tell you to 

PUT IhJ APPLEl: 

(if APFLEl: is yonr boot diskette). 

One-drive notei You can first use Che Filer to T{ranBfer the file 
LINEFEED. CODE from APPLET: onto your boot diskette. You are then 
ready to X(ecute LINEFEED with yout boot diskette In the drive. This 
works well because the boot diskette (and the necoasary file 
SYSTEM. PASCAL) is Hvailable wheu you return to COMMANT level after 
usiog the utility. 

Tvo-drlve note: You will notnially place your boot diskette in the boot 
drive, and place AFPLE3: in the other drive- You are then ready to 
Xfecute APPLE 3: LINEFEED . 



i ^ 

1 i 

f 3 
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USING THE UTILITY 

From coomiand level, with APPLE3: in any available drive, type X for 
K(ecute. Answer Che question 



hy typing 



EXECUTE WHAT FILE? 



APPLES :L1NEFEED 



One-drive note; You have Ttransferred LINEFEED-CODE to your boot 
diskette, AFPLEl: for ejcample> You should therefore type 

APPLE1:LINEFEFJ) 

(Note Chat you do not need to specify LINEFEED. CODE ; the .CQ]}E suffix is 
automatically added if you forget to type it.) The systen then 
executes LINEFEED. CODE . No mesaagoa are displayed, and the COMMAND 

prompt line reappears. 

After running this utility, until the neiRt system boot, RESET, or 
Inltiatljation, a linefeed is no longer sent to the printer after 
every RETUH^J character- This utility can he used to cure double 
spacing and other printer troubles associated with linefeeds. 



EASIER USE OF THE UTILITY 

If you use tlie same printer constantly, and It always needs to have no 
linefeed sent after RETURN characters, you will have to ei^ecute 
LINEFEED. CODE every time you start the sysCem. You could TCransfer 
LINEFEED. CODE permanently to your boot diskette, and that would 
certainly make things simpler, but you would still have to remember to 
Xfecute LINEFEED everytlrae you start the systetn. 

Fortunately, there is an easier way: make youra a "turnkey'* system^ 
which flutoraaticaily executes LINEFEED. CODE everytlme you start the 
system. To do this, simply Uransfer the file LINEFEED. CODE frooi 
APPLE3: to your boot diskette, and then C(hange its filename on the 
hoot diskette to SYS TEH. STARTUP . That's all there is to it. Every 
time you boot your system using that boot diskette, the file 
SYSTEM. STARTUP will be automatically executed. 
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CALCULATOR 



ThiB utility turns your Apple Into a VERY 9li!iple calculator capable of 
addition, subtraction, raulC IpU cat Ion , and division only. Boeults are 
expressed in pcl^ntlfli: notation, round<jd to b±k dlftita and followed 
by a povcr-Df-t*-n Indicator from E37 to E-37» Input aumbers must not 
be fiKpressed in scientific notation, and ahould not contain more than 
36 digits. 



DfSKFILES NEEDED 

The followlna dlskfllE Is needed in order to use Che calculatoc 
utility program: 



CAL C-CDD£ 



(any dlflfcette, any drive; required 
only to start) 



The file CALC-CODE la nonnally found an diskette APPLE3: * When you 
quit the ralculator pcograin, or when any errat terminateH the program, 
your bofll diskette uhould he in the boot drive. Tf It la not there, 
the system nay "hang" in more or lesa dramatic: ways, ot you nay Eee 
the DiEBsage 

PUT IN APPLEI ; 

(if APPLET: is your boot dlaketCe). Even after correctly responding 
to chia meaHage, you vlll often have to re-lnl tlaliae the syeteoi (by 
presging Che RESET key) before the Hyaten will respond noEmally to 
commaads again. 

One-drive note: "n single-drive ayateme, tJie safeat approach Is to use 
the Filer to Tfrangfet the file CALCCODE from APPLEi: onto your boot 
dlHkette before Xfecucing CALC . This is beat because the boot 
diskette (and the necessary file SYSTEM PASCAI,) is available when you 
return to COMMAND level after quitting the utility or after any etrot 
tenninates the program- However, you can start the calculator utility 
with APPLE3: in clie drive- When the utility's first prompt appears, 
you should then put your boot diskette In the drive. Be sure the boot 
diskette Is in the drive before you quit the calculator utility 
program, or your syatero may "hang". 

Two-drive note: You will normally place your boot diskette in the boot 
drive, and place APPLE!!: In the other dilve. You are then ready to 
X{ecute APPLZ3 CALC - 
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USING THE UTILITY 

From Command level* with APPLE3: in any auailable disk drive, type X 
for Xtecute. When you see this question 

EXECUTE WHAT FILE? 

respond by typing 

APPLE 3: CALC 

One-drive note: If you have T(ranaferred CALCCODE from APPLE3; to 
your boot diskette, aa auggested, you will respond by typing (assuming 
APPLE!: is your boot dlekette, tor cxaiaple] 

APPLE I ! CALC 

(Note that you do not need to specify CALCCODE [ the .CODE BuffiK is 
added automatically tf you don't type It.) After this response, 
CALCCODK Is executed, and this prompt appears Just below the top 

screen line saying EXECUTE WHAT FILE? : 



Vou may now type any simple iiistheiiiatical expreaalon, using only these 

operators : 

+ iddition 

!iubtractlon 
* mult Ipllcflt ion 
/ division 

Ail imiltipllcatlons and divisions are carried out before addltiona and 
aubtractiona are executed. Use parentheses to keep portlona of the 
expression unambiguous. When the eKpreaslon is as you want it, press 
the RETURN key to see the result. Here are a few lllxiBtratlve eKamplei 

->C2+3)*A 

Z.000bf0El 

DlViaiOH B¥ ZERO! TRT AGAIN 

->19. 2357/2873. ^56 
6.69A27E-3 

->^00. 23+1 2. 37+A5. 78-595. 9fl+I6. 00 
-1.2J&00E2 

->45"-2 

"(" MISSING: TRV ACAIN 

->45*(-2) 
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HeapondlDB to the prompt -> by Just preaaJng cho RETURN key 
termlnatea cha calculator utlUty and returns you to the operatlna 
eyacein'a Coinmand level. Be sure your boot diskette is In the boot 
drive before you quit Che proaram in this way. 

DccflEionally, you may run Into a problem like this: 

UN IMPLEMENTED INSTRUCTION 

Stf I, Pfl 10, IS 92 

TYPE <SPACE> Tp CONTINUE 

After a raeasage IJke this laet one, you should make aure your boot 

diskette is in the booC drive, and ihen press the Apple's epacebat. 

This cauaea the ayateii Co be re-boottd. and you can then Xtecutc the 
cfliculator uclllcy ataln. 



UTILITIES SUMMARY 



FORMAHING NEW DtSKEHES 

1. Xfecute APPLE3! FORMATTER 

2. When afiked FORMAT WHlCtt DISK? , put a new diskette In any drive 
and type tiiat drivfs'a volume number. 

3. To quit, prass the RETURN key in response Co FORMAT WHICH DISK? 



THE SYSTEM LIBRARIAN 

U Xtecuce APPJ,E3 : LIBRARY 

Z' When BSlced for an OUTPUT CODE FILE ^> , type & fllenflne for the 
new library file. E.g.. MYDISK; NEW. LIBRARY 

3. When asked for a LINK CODE FILE >> , type the naine of Che file 
which contains the firsc items to put in the new library, E-e-. 
APPLE1:SYSTEM. LIBRARY > i^ b . 

A. To transfer aa item from the source Link Code File to the new 
library Output Code File, type Che item's Link Code File slot 
number (E) to 15} and preaa the spacebar- When asked SLOT t^ LINK 
INTO? , cype the number of the slot you want the item to occupy In 
Che Output Code File and press Che apacebar- 

5. Type N to begin Caking ItEma Eron a Ntew Link Coda File- 



r 
r 
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E- 
g 
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3 
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6, When all desired Items have been CcansEerred to the new library, 
lock Che new library by typing q for Qtuit. When aafced NOTICE? 
Cype a copyughC message or press RETURN' 

7- To use the dew library, it must be placed on your boot dlskeCCe 
and It muat be nflined SYSTEM. LIBRARY 



LIBRARY MAPPING 

I. X(ecute APPLE3:LIBMAP 

Z. When prompted to ENTER LIBRARY NAME: , type Che nsme o£ the 

library or ochec code file whose contenCa yoa wish to see mapped- 
E.a». AFPLEliSYSTEH. LIBRARY 

3. When asked LIST LINKER INFO TABLE? , press the spacebar or RETURI4 
key unless you want that InfotDiation' 

A. WLien prompted for a MAP OUTPUT FILE NAME: , type the name o£ the 
diskette flic or other device to which you wish Che map seni' 
JusC pressing the RETURN key &ends the map to CONSOLE: < 

5. When prompted a^ain to ENTER LIBRARY ^lAHE; , type the name of the 
next library file wbusti contents you wish Tn^tpped. or press nhe 
RETURN key to quit the pTograio. 



SYSTEM RECONFIGURATION 

I- To use your system with an external terminal, make a copy of 
APPLEl: for ijse as your new hoot diskette* Give this new boot 
diskette a different name, such as SOHOCl: or BRIAN! - 

2. If your Cermlnal is a Snroc iqlZfl, TUansfer APPL£3:S0B0C.MISCINFO 
to your new boot diskette and change its filename Co SYSTEM.M ISC INFO 

If your tenuinal is a Hazelclne 1500, T(riinafec APPLE3:HA2EL.HtSCtP;ro 
to your new boot diskette and change its filename to SYSTEM. MISCINFO 

If your terminal ia neither of Che above, Jt(ecuCe APPLE3:SETUP , 
and let the program TCeach yau hnw to CChange the parameters to 

suit your ceTminal. When the parameters are ser correttly, Qfuit 
and do a D(lsk update. This oreateB Che file HEW.MISCINFO on your 
boot dlaketce. Hien E(Mlt Che program. Finally, you must 

Ttransfer HEW.MISCINFO co your new boot diskette and change Chla 
file's name :o SYSTEM.MISCINFO 

3. Read the nesr section, which tells how to change the GOTOKV Pascal 
procedure to work correctly with youc terminal. 
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CHANGING GOTOXY COMMUNICATION 

1. Read clic prevloue section on rccanf ifiuclny /our Bystsm to suit 
your eKternal CermJiial. 

2. J(<ecute APPLE3:BINDEH 

3. When you are asktd FILE WHICH CONTAINS GOTOXY? , type the name of 
the codefUe containing the new GOTOXY prucedure for your terminal, 
Une-drivK note: this file inu&t be on your boot dJi.kette> 

If your tecminal la g Saroc IQI20, type APPLE3:SaR0GG0T{J 

If your Cermlnal la a Ha^eLtlne ISWtf, type APPLE3 : HAZELGOTO 

If your terminal la neither of the above, type the name of the 
codefJle containing a new GOTOXY procedure thai you modified froin 
APPLE3:S0R0CGQTO.TEXT tc si>lC your terminal atid Chen eoiiipJleJ. 

A. Ihia pronraia cteatea the file HEW, PASCAL on your hoot diskette. 
You Euat now T(rans£er KEW-PASCAL onto Che new boot diskette 
created in the prevluua section, and change the name of thJs file 
to SYSTJ^H. PASCAL . Your ayatem will discover the new f 1 !e5 
SYSTHH.MlSCtNFO and SYSTEM. PASCAL the next time you boot with your 
new boot dJ&ketce- 



REMOVING LINEFEED FROM RETURN 

[• The Apple Pascal ayetein automatically supplies a linefeed after 
every KETLIRW character sent to the printer- If your printer doea 
not wurk correctly with thla arrangement, X(ecute APFLE3! LINEFEED 

2. Until tho nent boot, RESET, or initialization, no linefeed will be 
sent to the printer after RETUHK characters. 

3. You Tnay wish to put LINEFERlJ-CaDE on your boot dlakette, and 
thanije ita name to SYSTEM* STARTUP Then thl(> utility will be 
exacuted autiinatlcally, each the syeteiD Is btjoted' 



K 



CALCULATOR 

3 1- X(ecute APPIE3:CALC 



2. 
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si 
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^ 
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g 


a 



3. 



When you are pronpted -> , type any mathematical expresaion 
Involving declnal numbers uith fewer Chan 3b digits, and the 
operators ■* - * / Use parentheses ( and ) to keep 
expreB^ious unapbiguoua. Eitample: 

*>(i,32+-tJ29 J* £-1.75/4394- 17 J 

PresB the B^UEtN key Co see the result of evaluating the 
eHpression, expreaaed in scientific notation with sin digits and 
powec-of-ten Indicator- Result of above example: 



-^ 



4. 



-9.35501E-4 

In other notation, '9.35501E-A = -9-35501*{Ii» ) - -,1*00935501 
To quit, presH BETURJl when prompted -> 
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TECHNICAL INFORMATION 



INTRODUCTION 

The Appl? Pascal "Pseudo-machine'^ or "P-machlne", a version of the 
UCSD Pascal P-nachlne, is Che sof twate-Benetated "device" which 
executes ?-code as Its "machine" language- Every compucor operating 
under a forni cf UCSD Pascal has been progranmed Lo "look like" this 
coiomorL P-machine, frcni the vlcvpolnt of a program being execuced- 
Thtj P-machine aupparts the follcwlng: 



U Variable addresslngf Including flCrlnga, byte artaya, packed 
fields, and dynamic variables 

2. Logical, Integer, real, set, artay, and string top-of^-stack 
arithmetic and conqiarlHaiifi 

'i- Multl-eleioent flCrucFuze compariscDB 

A. Several types of hranchea 

5. Procedure and function calls and returns, Including 
overlayable procefliireE 

6. HlscellaneouB procedures used by systems programs 

This appendix^ to be used In conjunction with the next appendix 
OPERATION OF THE P-*lACHlNE, describes the P-machlne "hardware," 
cGnmninicatlon with the operating system, error handling, and the 
mnemonic Inatruction set, 

HARDWARE EMULATION: REGISTERS 

The P-machlne uses Ib'-blt words, with two 8-bit bytes per word- It has 
an evaluation stack, several registers, and a user memory containing a 
program stack and a heap- All reglaters are pointers to word-aligned 
sCrucCureEi t except IPC, which is a pointer tc byte-aligned Instruction!! i 
The registers, sometimes referred to as "pseudo-variables", are: 

SP: evaluation Stack Pointer- A pointer to the current "top" of the 
evaluation stack (one byte beyond the last byte in use). In the 
Apple, the evaluation stack uses a pprtion ot the 65ftZ's hardware 
stack> starting in hex memory location IFF and growing down toward 
hex location I0fl> Lt is used to pass parameters, return function 
values, and as an operand source for Toany Inst ructions- The 
evaluation stack is extended by loads» and is cut back by stores 
and arithmetic operations- 

IPC: Interpreter Program Counter. Contains the address of the next 
Instruction to be executed, in Che code segment of the currently 
executing procedure- 
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SEG: SEGment painter points to the procedure dictionary of the segment 
to which the currently executing procedure belongs. {See this 
manual's appendix OPERATION OF THE P-MACHTNE for Illustrations ,) 

JlAfl: Jump TABle pointer- A pointer to the table of attributes and 

jump table entries In the procedure code section of the currently 

executing procedure. (See this manual's appendix OPEHATIQH OF THE 
P-^HACHINE for lllustracions. ] 

KP: program stacK Pointer- A pointer to the current top of the 

program stack* The program stack starts In high user meniory and 
grows downward toward the heap- (See this annual's appeadix 
OPERATION PF THE P-WACUINE for Illustrations.) 

MP! Jferkstack Pointer- A pointer Co the low byte of MSSTAT, In the 

topmost Eiarkstack on the program stacks In the activation record at 
the currently executing procedure. Variables local to the current 
procedure are accessed hy Indexlnfi off HP- 

NP: Kev Pointer- A pointer to the current top of the dynamic heap 

(one byte beyond the last hyte in use)- The heap starts in low user 
memory and grows upward toward the program stack- It contains all 
dynamic variables (sen Jensen and Uirth, Chapter 10)- It la 
extended by the standard procedure 'new', and Is cut back hy the 
standard procedure 'release' . 

BASE; BASE Procedure. A pointer to the activation record of the nuat 

recently invoked base procedure (lex level 0). Global (lex level V) 
variables are accessed by Indexing off BASE. 



COMMUNICATION BETWEEN OPERATING 
SYSTEM AND THE P-MACHINE 

J It Is sometimes necessary for the operating aystpm and the P-machlne 
jj to exchange information. Hence there exists a variable SYSGOH in the 
outer block of tne operating system, and a corresponding area in 
memory known to the P-machine- The fields in SVSCOM actually relevant 
'^ to this Communication are: 

lOASLI: Contflins the error code returned by the last activated or 

terminated l/O operation (see l/U Error Messages In this manual's 
^ TABLES appendix, and the Apple Pascal Language Reference Manual's 

^ description of Apple Pascal's read and write proceduresj- 

-^ XEl^EHK: Contains the error code of the last execution error (see 

jH the Error Handling section in this appendix, and Execution Error 

Messages In the TABLES appendix). 

id SfSUNIT: Contains the volume number of the device from which the 

J3 operating system was booted (usually the boot disk drive, volume 4 ) 

BUCSTATE: (Not used; intended for tutute debugging routlnea-1 
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GDIRP: Contdins a pointer to the ibd^c receni disk directory read 
In, unlsBB dynamic allocation or deallocation has [alcen plaice 
since then (see che ^H(K, HLS , and NEW insLructions} - 



STKBASE, LAETMP, SEG, JTAB: 

JTAB reglsCDra, 



Containa Copies of the SASEi HP, SEG and 



BOtlBP; Contains a pointer to tha activation record of the apcratlng 
systecn routine GJtECERROB when an execution error Gccurs faee the 
Error Handling section of tliis appendix). 

BUMTPC: Contains the value of IPC when an execution error occurs. 

ULTLIHE; (Not used; Intended for future debugging routined.) 

BRKETS; (Not used; intended for future debugBinfi routines. 1 



g 11 

e : 3 

t 3 



CRTIHFLl.EOF: ContainB the end-of-flle character (see discussion of theK 

recduflguration program In this manual's chapter UTILITY FR[>CRAM5). K 

CariNFO^FLUSJl: Contains the flush-output chacacter (see the dlstusalon 

of the reconfiguration program in the chapter UTILITY FROGBAHS ) . H( 

CBTINFO-STOP; Contains Che sCop-output character (see discussion of the 

reconfiguration prograci In this cmnual's chapter UTILITY PLIDGRAMS). 



fl 



CKTINFU.BREAK: Contains Che hrefik-execution character (see discussion 

of Che reconfiguration prograni in the chapter UTILITY PROGRAMS). 

SRGTAbLE: Contains the segment dictionary for the operating systein ^P 

(segDients 0, and 2 through b) and for the currently executing system 
or user program (segoient 1: Luain program; 7 through 21: segment 
procedures and regular Units: ^^ through 31: Intrinsic Units) ^ 

(see the appendix OPERATION OF THE P-HACHTNE foe Illustrations J . C 

ERROR HANDLING 

Whenever an execution error occurs, the P-machine stops executing the 
current Instruction (Ideally Leaving the evaluation stack in aa nice a 
condition as poasiblcl and transfers control Co the interpreter's KEqEHR 
routine^ This routine does the following: 

1. Enters the error code into SYSCOM-.XEQRRR , 

2. Calculates what MP tflll be after step 4, and sets SYSCOM^.BOMBP 
to that (the aiae of EXECCHHQR's activation record imiat be 

known by the P-machlne), 

3. Stores the current value oE IPC into SYSCOM'.flOMJPC , 

A. Points IPC to a CXP 0,Z P-code infltrucclon (call operating 
aysten procedure DCHCERRURJ and 

5p Resumes execution of Interpreter code, starting with the CXP . 
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OPERAND FORMATS 

Although an element of a structure may occupy as Uttle as one bi t . as 
in a PACKED AflHAY OF boolean, variables In the P-machine are always 
aliened on uovd boundariee. Words consist of two bytes of which the even- 
address byte Is lease significant. All top-oE-stack operations 
expect their operands to occupy at least ont^ word on the evaluation 
stack even if not all the information in a word is valid. The 
least'signiflcant bit of a word is bit 0, the moat significant is 

bit 15. 

BOOLEAN; One word- Bit 9 indicates the value (false-fl, true-l), 

end this is the only Information used by boolean comparisons. 
However, the boolean operators LAND, LOR, and LNOT operate on all 
lb bits. 

ISTEGEH: One word, two's complement, capable of repreaenting values 

in Che range -32766 . .32767 . 

LONG IPJTECiER: 3-. II words. A variable declared as INTEGEflfn] Is 

allocated (tn+3) DIV 4) + 2 words. Regardless of the value of the 
integer, its actual slaa agrees wUh ita allocated size. Each 
decimal digit of a long Integer is stored as four bits of fllnary 
Coded Decimal. The format of long Integers Is as follows: 

word n (tos-nj: high byte contains the two least significant 
decimal digits (BCD). 



word 2 {t.nB-1): low byte contains the two mosc significant 
decimal digits (BCD). 

vord 1 (tos-U: lou byte contains the sign fall zeros-plus, 

all ones ^ flilnus)- high byti^ not used. 

word (tos-tf); contains the allocated length, in words. 

SCALAR (user-defined): One uord, in range 3.-32767- 

CUAR: One word, with low byte contalnini character. The internal 

character set is "extended" ASCII, with 0..1Z7 representing the 
standard ASCII set, and I2S..255 as a user-daflned character set. 

KEAL: Two words, whose format U implenentation dependent. The aystein 

la arranged so that only the Interpreter needs to know the 
detailed internal format o£ EiiALa (beyond the fact that they 
occupy two vorda). In general, the format for 32-bit real 
numbers Is aa follows: 

Word 1 (tos) Word 9 (cos) 



^ 



r 

Bit! 31 13. ..?3 2?-. lb and 15. 

Item: Sign Exponent Mantissa 
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POINTER: On* or rhcM wordB, depending en type of painter. 

Pasca; polnterfl. internal ward pdlxiter.*: one «Qrd, crmtal;)lns 
a vord address. ° 

Internal byte pointers: ane wrjcd, containing a byte address. 

Internal packed field poincecs: three words. 

word ? (Toa-Jl: uord pointer to word field ia in 
ward I (Tos-l): Eield width Cm bite), 
word tTos-0): right bit nuraber of Held- 

SET: 0,.K words in activation record, 1..3? words on evaluation 

stac^. Setfi are Impleioented as bit vectors, alwavs with a lower 
index of zero. A set variable declared bs SET OF iD..p is 

recn^^'^/°''^-* ^iT '^ 7''^'' '^'" " "'^^ ^" ^'^ ^"^ activation 
record, all worJs allocflted contain valid Information (the set's 
acCUfll size agrees with Its allocated el^e). 

When a set Is on the evaluation stack, It is represented by a word 
eontalnine the length ftos). and then that number of words of 
infomation. The sec may be padded with exLra words (to compare 
It with another set of different size, sav), the length word 
IndicflclnE Che number of words In the atrut^tbre padded. Before 
being stored bstk in the activation record, a set na^et be forced 
back to the size allocated to It. by Issnlng an WJ Instruction. 

RECORDS and ARRAYS: Any number of words. Arrays ar^ stored in forward 
order, with higher-lndeju-d array ele,3ents appearing In higher- 
numbered loeoiory locations. Only the address oE the record or array 
is loaded onto the evnlnatton stack, never the structure itself. 
Packed arrays tmat have an integral number of elemants in each 
word, as there is no packing across wrd bcundgrlea (it Is 
acnepcable to have unused bltj; In eadi word). The first element in 
each word has bit fl as lt& low-order bit. 

^^"^^^1, '"^^^ "°'''*^" ^^^^"S^ «" « flexible vereion of PACKED 

ARRAYS OF char. A strlngCn] occupies (n DtV 2)+l words. Byte 
of a string is the current length of the string, and bytes 
K. length {string J contain valid charscterH. 

CONSTANTS! Constant acaJars. sets, end strings may be Imbedded in 
the Instmcclon stream, in which caae they have special formats- 

All flcalara fexcluding realp) greater than 127: IVa bytes 
high byte first- 
Strings: Ml string literals take lengChf llteral)+] bytes, and 
are word aligned. The first byte Is the length, the teat are the 
actual characters. This fomidl applies even If the literal should 
be interpreted aa a PACKED ARRAY OF CHAR. 

Reals and sets: Word aligned, and in REVERSE word order. 



^F^ THE P-MACHINE INSTRUCTION SET 

til3 INSTRUCTION FORMATS 

I ^ inatnictlons on the P-tiiachine are one or two bytes lonft, followed by 
aero to four pBrametera. Most parameters specify one word of 
information, and are one of five basic types: 



^ 



t 5 

i 3 



t 3 



t -1 



IS 



tU 



UB: 
SB: 

DB; 



Unsigned Byte- High order byte of parameter la Implicitly zero. 

Signed Byte. High order byte is sian ejctenslon of bit 7. 

Don't-care Byte. Can be treated as SB, or [JB, aa value Is always 
In Che rsDge (J--127. 

B: Hig. This paratneter is one byte long when used to represent 

values In the range (J. .127, and is two bytes long when 
representing values in the rdnge 12B..3Z767. tf the first 
byte is in 0..127, Che high byte of the parameter la 
implicitly iero. Otherulae, bit 7 of the first byte la 
cleared and it la used as the high order byte of the 
paraneterh The second byte is used as the low order bytCi 

Wi Word. The next two bytes, low byte flrsC, give the parflmeter value 

Any exceptions to these focmats are noted in the Instruction descrlptlonfl 

CONN^NTIONS AND NOTATION 



The proBram stack, which starts at user high memory and grows downward. 
^1 f:ontalDS prograin code segments and activation records for currently 
^ active procedures, and data segment: 
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associated with INTRINSIC UNlTs- 



The evaluation stack, which atarta at hex location IFF and grows 
downward toward hex Ifli*. contalne operands and other cenporary items 
needed during expression evaluation. When an instruction is said to 
"push" an item, that item is placed on the top of the evaluation stack 
(remetaber Chat the evaluation stack grows downwacd)- 

In reforrinB to operand^; on the evaluation stack (for example, tos or 
toB-1 ), each operand can contain from one word to 25fi words, depending 
on the context. Also, unless specifically noted to the contrary, 
operands used by an Instruction are popped off the evaluation stack 
{removed from the stack and not put back there) aa they are used' 

Abbreviations are used widely, hut uHe lairly simple conventions. 
ParameterH are written as X or Xn , tAere X is UB , SB , DB , B , 
or W , and n la an Integer Indicating the parameter poginion in the 
inatruction Cuaed In the descriptions Co differentiate between several 
parameters that would otherwise have the same namel. The tecni tos 
mesoB the operand on the top of the evaluation stack, tos-l Is the 
next operand, etc Tlie Mark Stack Control Word, or >ECU, ia simply 
called the Harkstflck. 
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Many inBtfuctionti fefer to Che activation ri-cord of a procedure and 
thlH appendix flflgume!. [he reader has a general knowledge of procedure- 
calling In stack machines, and the concept of acack frames. An 
activatlOD record as defined In thlg appendix apecIflcaLly cooalstfl of: 

1) the local variables for the procedure, 

2) parameters pas^Ejd to the procedure at The time of Us invocation. 

3) apace for storing the value returned by the procedure, if the 
procedure ie a function, and 

4) the Marlcgtack, containing flddreasliiB Information (Static Links) 
and Information on the callina procedure's environment when the' 
procetiure was called (see this manual's appendlit. OPERATION OF 
THE P-HACHINE, for UlnatrfltionsJ . 

The dynamic chain refers to the calling chain, traversed uBlne the 
Markstack Dynamic Links (HSCW.HSDYN) . ^The static chain r^e?f to .he 
EMSCwtMSSTAT)'^^"" "^^^"^ travoraed usinfi th^ Marketack Static Links 

The columns of Inforiiaclon In the Various Instruction descrlptlouB may 
he labelled as followa; ' 



Column 
1 

Op-Code 
Hnemonic 



Colijran Column Column 

Z 3 A 

Declnal Instruction Full Name and Operation 

Op'-Code Parameters of the Instruction 



if -?! 


Local 




E 


^ 


SLDL 1 
SLDL 2 


21b 

217 






SLDL 16 


231 


t 


§ 


LDL 


702 




3 


LLA 


198 


£ 


a 


STL 


204 


1 


^ 


Gioba 




E 


3 


SLDO 1 
SLDO 2 


232 
233 


E 


3 


SLDO t iy 
LDO 


247 
169 



1^3 



ONE-WORD LOADS AND STORES 



LAO 



ShO 



165 



17i 



Constant 

SLUC 

SLUC 1 I 

SLDC 12 7 127 

LDCN isy 



Short load one-^uord conatant. For an 
Instruction SLDC x , push Che opcode, x , 
with high byte aero- 



LDCl 



199 



Load constant NIL. Push the impleraenta- 
t ion-dependent value of NIL (0, on the Apple). 

Load ooe-word constant. Push W- I 



E 3 



Intermediate 



LOD 1B2 DB,B 



LDA 178 DB,B 



230 APPL£ RASCAL OPERATING SYSTEM 



1^3 



STR 



184 DB,ti 



Short load local word- For an 
Instruction SLDL x , fetch the word with 
offset X in KP activation record and 

push It- 

LoBd local word- Fetch the word with 
offaet B in KP activation record and 
push It. 

Load local address . Fetch address of 
the word with offset B In MP activation 
record and push It- 

Store local word- Store tos into word 
vith offset fl in MP activation record- 



Short load global word- For an 
tnBlEuctlDH SLDO x . fetch the word with 
offset X In BASE activation tecord and 
push it- 

Load global word- Fetch the word vl th 
offset B in BASE activation record and 
push it. 

Load alohal address. Fetch addreaa 
of word with offset B in EASE activation 
record and [insh it. 

Store global word- Store tos into word 
with offset n in BASE activation record- 



Load intermediate word- Fetch word with 
offaet B in the activation record found 
by trav^ersing DB Static Links, and push it- 
Load IntoriTiedJate address. Fetch address 
of word with offset B in the activation 
record found by traversing DB Static Links, 
and push ![■ 

Store intermediate word. Store toa into 
the word with offset B in activation record 
found by ttaveralng DB Static Links- 
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Indirect 



SIND 1 249 

StND 2 230 

SIMD 7 255 

IND 163 



STO 154 

Extended 

LJJE I a? 

LAE 167 

STE 209 



f 1^ 



Load Indirect word. Fetch the word 
pointed Co by cos and puah It Cthls is 
a special case of SIND x ^ described below). 

Short jQde» and load word^ For an 
Jnscruction SIND x , Index rhe wotd pointer 
tOB by K worda, and push the word pointed 
Co by the rsBulc. 

Static index and load word- tndeii 
the word pointer toa by B words, ;md 
puah Che word pointed Co by the reaulc. 



Store Indirect word- Store 
the word pointed to by Cos-l . 



toB Into 



^■^ Load extended word. Fetch the word 

Vltli offset B in data aegment UB 
(from an Intrinsic Unit} and push ic- 

^^F^ Load extended address. Fetch address 

of Che word with offset B in data aeginent 
UB (frodj an Intrinsic \iuil) , and push It- 

^B»fi Store extended word' Store toa 

into the word wlch d££sbc fl In data 
aegment UB (from an Intrinsic Unit)- 



MULTIPLE-WORD LOADS AND STORES 
(REALS AND SETS) 



E 5 

t i 

E ^ 

■ M 

f 1 

E i 



r 

6; -3 



LDC 



LDM 



STM 



179 



IS£ 



ie9 



UB.<bloek> Load multiple-word constant. Fetch 
word-aligned <blocl5> of UB words in 
reverse word order, and puah the block. 



UB 



UB 



Load nailCJple wordB- Fetch a block 
of DB words, whose beginning is pointed 
to hy tos J and push the block. 

Store [Tiultlple words. Tos is a block 
of Ufl words, Cds-I Is a word pointer to a 
slmJliar block. Transfer che block from tos 
to the destination block pointed at by tos-1. 



\ ^ 
E 3 
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BYTE ARRAY HANDLING 



LDb 



SIB 



190 



191 



Load byte- Tndex the byte pointer 
Cos-l by Che integer index tea , and 

push the byte (after zeroing high byte) 
pointed Co by Che reaultlng byte pointer. 

SCOfe byte- Index the byte pointer 
tDS-2 by Che integer Index tos-l , gnd 
push the byte toa into the location 
pointed to by the reanltlng byte pointer. 



STRING HANDLING 



LSA 



SAS 



166 



1713 



IXS 



155 



UB|<chars> Load constant atrlna address. Puah a 
byte polnteE to the location containing 
Ul, and Chen skip IPC past <cbarH>. 

UB String assign. Toa is elctier a source 

byte pointer or a chacacCer- (Charactera 
always liave a high byte of aero, while 
pointers never duO Tos-1 is a desitlnatlan 
byte pointer. UB la the declared aize of 
the destination string. l£ the declared 
sii:s Is Less Lban the current size of the 
source Etrlng, give an execution error; 
otherwise transfer all bytes of source 
containing valid inf omiat Jon to Che 
destination string' 

Index string array. Index che byte 
pointer tos-l by the integer Index tns , 
and push the resulting byte pointer If 
it Is In che range L .'Current length - 
If not, give an execntion ercor- 



RECORD AND ARRAY HANDLING 



MOV 



INC 



Ibti 



lez 



rtuve words* Transfer a source hlock of 
B words, pointed to by byte pointer tos i 
to a similar destination block pointed to by 
byte pointer tos-l . 

Inccemenc field pointer. Index the 
word pointer tos by B words and push 
the resulCfint word pointer- 
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IXA 



:xp 



192 



LPA 



LDP 



aip 



1^* fl Index array. Toe la sn jncegtr Index, 

tOfl-1 Is the array base ward pointer, and 
B ia the size {la words) of an array 
element. Compute a word pointer to Che 
Indexed element and puah the pointer. 

UBl,UB2 Todex packed acray, Tqh js an 

Integer IndeK, tos-l is the array base 
vord pointer. UBL 1b Che number of 

elementH per word, and UB2 la the field 
width (in bits). Compute a packed field 
pointer to the Indexed flold and puah the 

resulting pointer- 

UB,<chflra> Load a packed array. Push a byte 

pointer to the first location following 
the one that contains UB , anil then 
skip IPC past <chflr9>. 

Load a packed field* Fetch the field 
Indicated by the packed field pointer cos 
and push It^ 

Score into a packed field. Store the 
datfl cofl into the field indicated by the 
packed field pointer toa-i . 



20a 



186 



lb7 



DYNAMIC VARIABLE ALLOCATION 



W£W L58 I 



MEK 158 31 



RLS 158 32 



New variable allocation. Toa is the 
Size fin words) to allocate the variable, 
and tOB-l Is a word pointer to a dynamic 
variable, GUIRP ia a pointer to a temporary 
directory buffer placed in memory directly 
above the heap. If GDIRP ia non-NIL, 
set GDIftP to NIL, Store HP into the 
word pointed to by tos-1 , and JntreEnent 
NP by tos words. 

Mark heap. Set CDIRP to NIL ff 
necessary; then store NP Into 
the word indicated by word pointer toa . 

Release heap. Set GDIRP to NIL, 
then store the word indicated hy the 
word pointer tos Into N|* , 



r 


n 


ft 


^ 


E 


^ 


i 


3 


F 


§ 


1 


§ 


^ 


§ 



TOP-OF-STACK ARITHMETIC 



Integers 

Note: OvErflowB do not cause an execution error. 



Afll 



AJ)X 



HGI 



sai 



MPI 



1A5 
149 
U3 



E 3 



L. 



SQI 152 



D71 134 



5 


^ 


MODI 


U2 


S 


^ 










CUK 


136 


E' 


3 








^ 


EQUI 


195 


k> 


NEQI 
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•^ 


LEQX 


200 






LESI 


I9i 




3 


GEgi 


196 


e 


GRTI 


197 



e a 



Absolute value of integer. Push Che 
absolute value of integer tos . Result 1j 
undefined If tos ia initially -32?5fl- 



Add integers. Add toa 
and push the reaulclng aum. 



and toa-l 



Negate integer, 
complement of tos 



Push the two's 



Subtract integers. Subtract tos frooi 
to8-1 , and push the resulting difference* 

Multiply integers. Multiply tos and 
tos-1 , and push the reaulting product. This 
instruction may cause an overflow if Che 
result is larger than 16 bits- 
Square integer. Square tos , and push 
the result. May cause overflow if result Is 
larger than 16 bits. 

Divide integers. Divide tos-L by coa 
and push the reaulting integer quotient (flay 
remainder is discarded)* 

Modulo integers- Divide toa-l by tos 
and push the resulting remainder (as defined 
in Jensen and Ulrth). 

Check agalnat subrange bounds. Insure 
that toE*l <■ tos-2 <= tos , leaving toa-2 
on the stack. If conditions are not 
SBtiafied, give an execution error. 



Tos-I 


- 


tos 


Tos-I 


<> 


toa 


TOB-I 


<" 


tos 


Tos-l 


< 


tos 


Tofl-l 


>•= 


tos 


Toa-l 


> 


tOB 



Integer coLUpariaons. CoEopare tos-1 
and push the result, TRUE or FALSE, 



to tos 
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Non-Integer Comparisons 



Equ 

NEQ 

L£Q 
LES 
GEQ 
GRT 



175 


UB 


1B3 


UE 


180 


UB 


LSI 


Ub 


176 


UB 


177 


U£ 



Tog-L " toa 




Tqh-1 <> tos 




Tos-i <= Tag 




Toa-1 < toa 




Tos-i >" tos 




Toa-1 > cog 




Compare cqe— 1 ta 


Eds , Jtnd push che 


ceBulC, TRUE or FALSE. TVie type of 


ccnpariBon is specified by UB : 


CantuntH oC 


Value of QB 


Tog-1 & cos 


for Campari 3on 


realg 


1 


atrlngg 


4 


boo leans 


6 


HCtd 


8 


byte arraya 


10 


words 


12 



CoDLparlBoDS using specific values of OB 
are shewn In the fallowing inaCructlon 
dcscrlptiociB- 



Reals 



Note: All over/undeTflovs cause an execution error. 



^ 


Ti 


ADR 


131 




r 


§ 


NGR 
SBR 


Ufa 
150 




E 


§ 


MFR 


UA 




i 


a 


St^K 


15^ 




E 


^ 


DVK 


135 




i 


§ 


POT 


15e 


35 


E 


§ 








& 


3 


EqUREAL 
NEqREAL 
LEgREAL 

LESREAL 


175 
lJa0 

lei 


2 
2 


& 


^ 


GEQREAL 
GTRREAL 


176 
177 


1 
2 



FLT 



FLO 



TJJG 



AND 



ADK 



L38 



137 



Float top-of-fitai^k. Convert Che InteESf 
tos to B floating point number, and puah H 

the result- ^ 



158 22 



15S 22 



Float next to top-of-atack. Tos is a 

Teal, CGE-l Is an Integer- Gonuert toa-l 
to a real nEimbEC, and push the result. 

Truncate real- truncate (as defined In 
Jensen and WJrthJ the real tos and convert 
to an integer, and then push the result. 



Round ceal. Kound (as defined In Jf^naen b| 
and Wirrtli) the teal toa , then truncate and " 
conveirt e.o an Integet, and finally push the 
result ■ 



t ^ 



129 



Abaalute value of re^li 
abgolute value of the ceal 



PuEh the 
toa ■ 



i 



Strings 

KgUSTR 
NEySTR 
LEi/STR 
LESSTB 
GE^jSTti 
GHTSTR 



175 
\&2 

IBI 
176 
177 



Add reals- Add toa and tos-l , and 
push the resulting sutn- 

Negate real. Negate the real tos , and 
push the teault- 

Sub tract reals. SuhtracC toa froni 
CQfl-l , and push the regultlng remainder- 

Multiply reals- Multiply cos and tos-I , 
and push the resulting product. 

Square n>al. Square toa » and push the 
result- 



Divide reals* Divide tos'-l by 
and push the resulting quotient- 



tos 



Power of ton. If the Integer tos ia 
In the range fl <' tOE <° 38 , puah the real 
(and thus Implenontatlon-'dependent > value 
m " tos . If not, give an execution error- 
This facility allous the rest of the syatecn 
to be Independent of floating point Connati 



TOH-i 


o toa 


Tos- 1 


<^ tcs 


Tos- 1 


<= tua 


ToH-1 


<r top 


Toa-l 


>■= toa 


Tos-l 


> tns 


Real compa 


rlsons. 


to the real tos , 


TRUE or FALSE, 



Coinpflre the real tos-1 
and push the result. 



TOH-1 

Tos-I 

Toa-l 

Toa-I 

To 3- 1 

Tos-1 

String comparisons. Find the string pointed 
to by word pointer tos-1 , compare It 
lexicographically to the string pointed to 
by word pointer toa , and push the result, 
TRUE DC FALSE, 



= 


toa 


t> 


toa 


<■ 


[OS 


< 


tos 


>= 


tos 


> 


toa 
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Logical 

UJUl 132 



Uia 



LNOT 



Sets 

ADJ 



SGS 



SRS 



IHN 
IfflJ, 
IHT 



141 



U7 



El^BOOL 175 6 

LEQflOOL 1B0 6 

LESliOUL 181 6 

GllQflOOL 176 6 

GRTflOOL 177 b 



1&0 



ISi 



U0 



L39 



13& 



140 



UJi 



r \~^ 



Logical 


and- 


Cofl-1 AMD 


Cos ■ 


Logical 


or- 


Cob- I OR t 


QB i 


Logical 


QOti 


of tos . 




lOB-l = 


tos 


Tqs-1 o 


tos 


Tos-1 <= 


to a 


Tos-i < 


tos 


Tas-1 >= 


tUB 


Tofl-1 > 


C.DB 



Push the result of 



Puflh the result of 



Push the oup'b complEment 



Boolea u compar 1 b ans 
tns-l to bit of 



Conpare bit 9 of 
toa and puah the 



result, TRUE or FALSE. 



Adjust set. Force the set tos to occupy 
Lffl words, either by expanafon (putting zeroes 
*'betueen" toa and tos-L ) or conpreseion ^ 
{chopping of high werda □£ set], discard Che jj^ 
length word, and puah [:hi> resulting set' 



Build a singleton set- It the integer 
tos is in the range <- tos <^ 5U , 
puflh the set [tosj . If not, give an 
execution error. 

Build a subrange set. If the integer 
toa is in the range <= C03 <= 511 , and 
the Integer tos-I Is In the same range, 
push the set [toa-l.-tos^ (push the Bet [] 
if toa-1 > tos ). if either integer exceeds 
the range, give an ejcecutlon error. 

Set membership- If integer tos-l is 
In set tos , push TtLljE. If not, puHh FALSE. 

Set union. Puah the union of sets Cos 
and tos-1 . { tos OR tos-l ) 

Set Intersection. Push the intersection 
of sets tos and tos-1 



I 
i 



E i 



§ 



t 

i 1 
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the intersection ^ 

< tos MtD tos«l ) mk—'. 9 

f 9 



□ IF 



SEQUPOWK 
NEQFOWH 
LEQPDWE 
GEQFOWR 



133 



175 
1S3 
1B0 
176 



Set difference, push the difference of 
HetB CoH-l and tos - ( tos-1 AND NOT tos ) 



Tos- 1 ■* 

Tos-1 <> 

ToB-1 <* 

ToB-1 >° 



tos . 

tOB . 

{subsel: of) tos - 

(superset of) toa 



Set comparisons- Compare set toa-1 to the 
set tos , and push the result, TRUE □[ FALSE. 



Byte Arrays 




EQUBYT 


175 10 , 


B 


NEqBYT 


ia3 10 , 


B 


LEQBYT 


La0 10 , 


B 


LESBYT 


ISl 10 , 


E 


GEQBYT 


176 Ifl , 


B 


GRTBYT 


177 10 » 


B 



T09-] 


=. 


tOB 


TOB-1 


<> 


tOfi 


TOB-1 


<- 


tos 


Tos-1 


< 


tos 


Tos-1 


>- 


tos 


Toa-1 


> 


toe 



Byte array comparisons. Compflre byte array 
to&-l to byte array tos , and puflh the 
result, TRUE or FALSE- <", <, ?-, and > must 
be used with PACKED AERAYa OF CHAR, only. 
B gives the number of bytes to con^iare. 



Records and Word Arrays 



EQUWORD 175 12 , B 
NEQWORD 1B3 1! , B 



Tos-1 ' tos . 

Tos-1 <> tos . 
Uocd or ruultlvord structure comparisons. 
Compare word structure tns-I to word 
structure tos , and push the 
reaulc, TRUE or FALSE. B glvea 
the number of bytes to compare. 



JUMPS 

simple fnon-case statement) Jumps are all two bytes long. The first 
hyte Is the op-code, the second is a SB jump offset. If this offset 
iB non-negative. It is flimply added to IPC- <A value of zero for the 
Jump offset will make any jump a two-byte NOP.) If SB is negative, 
then SB DIV 2 is used as a word offset Into JTAB, and IPC is act to 
the byte addrese (JTAfl"[SB DIV 21) - contenta of (JTASrSB DIV 2]). 



II JP 



FJP 



105 



Ibl 



Sb 



SB 



Unconditional jump, 
deflcclbed above. 



Jump aa 



False jump. Jump If tos la FALSE. 
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£fj 



m 



Zt2 



172 



SB Equal fa lap jump- Jump Jf integer 

toH-l <> Integer cob - 

58 Not equal false Jump- Jump ii Integer 

toB-l = integer coa . 

Wl,U2,W5, cease t:able> 

Case jiJOip' Wl le word-aligned, a[;d 
la Che TiLlnJuiuni Index of the cable- W2 is 
the laaxiimim Index- W3 is an uncondJ CJonal 
Jump Ins Cruet ion past Che Cable- The case 
table la (Ml - Wl + I) words long, and 
cDDCains aelf-relfiClve locaclons- 

If tos , the ai^tual Index, is not In 
Che range Ul . -W2 , Chen point IPC at W3 . 
Dcher-viae, ose (tos - Vl) as sn Index ini:a 
the case table, and set IPC co che hyce 
address (crdsetable [Cos-WU ) nilnus Che 
concents of (casecablelcos-Wl] )■ 



r 

r 



CLP 



PROCEDURE AND FUNCTION CALLS 

The general acheme used tn procedure /func^Ci on InvocaCJon is 

I) Find the procedure code section for Che called procedure. 



E 
E 
E 
E 



From the table of aCtribures (JTAB) in the called procedure's C 
code section^ find the data size and parameter sIee of Che C 

called procedure (for more details, see this manual's appendlK, 
OPERATION OF THE P-MACHINE). 



ZJ EjiCend Che program stack, by a nuraher of hytea equal Co the 
data size plus the paramecer size- 

3) Copy a number of byCea equal Co Che parameter size, from the 
evaluaCJon stack'a Cos [pointed to by SP) to the heBinning 
o£ Che space JueC allocated. This passeu paraiDeters Cc Che 
new procedure from its caller- 

4> Build a Markatack, gavlnft SP, IPC, SEC, JTAB, MP, and a Static 
Link pointer to Che nioeC recent accivatlon record of Che called 

procedure's Iminedlatc parent, 

5J Calciilace new vflluea for SP, IPC, JTAB , MP, and If necessary, 
SEG. Check for program stack overflow* 

e) If the celled procedure has a lex level of -I or Q save MSE 
on the evaluation stack and calculate a new BASF. 

7) Save KP on the program stack and calculate a new KP - 
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E 
E 
E 
E 
E 
E 



5 



CGP 



ClP 



Zflb 



237 



174 



UB 



UB 



CBP 



194 



GXP 



235 






UB Call local procedure. Call procedure 

Ufl , which la an Imrnediate child of the 
Currently executing procedure and in the 
same Segment- Static Link of Markstack 
is sec CD old MF- 

Call global procedure- Call procedure 

UB , which is ac lex level I and in the same 
segment as the currently executing procedure, 
ScsCic Link oE Che Markstack is set to HASE;> 

CbU. intermediate procedure- Call 
procedure UE Jn aanie segiiTLenC as the 
currently executing procedure. The Ststlc 
Link of the Markatack Ib net by looking up 
Che call chain until an activation record 
is found whose caller bad a lex level one 
leas than the procedure being called- Use 
that activation record's Static Link aa 
Che Static Link of the new Markscack- 

UB Call base procedure- Call procedure 

UB , which Is aC lex level -1 or fl- The 
Static Link of the Markatack is set to the 
Static Link in BASE'a activation record- 
The BASE la saved, after which It Is 
pointed at the acclvaclon record just 
created. 

[/RUtjB2 Call external procedure- Call procedure 

UB2 , In segment UBl . [faed to call 

any procedure not in the saifie eegjnenC 
as Che calling procedure. Including 
procedures at leu Level -1 or 0- It works 
as follows: 

IJ l9 desired segment In memory? 

2a) No: read in segmenc from disk 
using the Inf orraac Ion In the SEGTAflLE, 
Chen build an activation record- 

?bj Yes: build activation record 

normally. 

3) Calculace the Static Link for 
the fiarkstack; If the called procedure has 
a le^ level of -I or 0, set aa in CBP; 
otherwise set aa in CIP- 
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C3P I3E tIB 



sue 1 73 DB 



EiSP 193 Dfl 



EXIT 158 ^ 



Call ,'jtsnd^rd procedure. Call the 
standard Paacflt proct^duro (JB , where 
UB is used as an Index !nCo the CSP 
table In Che Interpreter- Ail Instrucrlonfl 
with decimal op-ccde 150 are oKauipleH 
of procedure calls using the CSP 
instcEietion- 



Return from non-bsee p 
is Che nuDiher of words Cha 
resumed as a functlnn val 
pracedureSi I for non-real 
2 tor real Eunctions) . Co 
from Che bottam of the cue 
acCJvaClun record, and pus 
evaluation stack- Th«n ua 
in Che current Markatack c 
calling procedure's correc 



rucedure. D0 
C should be 
ue (fl for 

functions , and 
py DB words 
rent procedure' s 
h them onto Che 
e the Information 
restore the 
t environment. 



Betum from base procedure. Move Che 
saved base into BASE, and then proceed as 

In the HNP instruction. 

ExJc from procedure, Toa is che 
procedure number, toa-l is the segment 
miEnbef' First, aet IPC Co polnc to 
cha exit code n£ Che currently 
executing procedure- Then, If the 
current procedure Is the one to exit 
from, reCum control to the insttuccJon 
fetch loop. 



I 
f * 

i 
i 

E 
E 
E 
E 
E 



UtherwEsei change the IPC of each ^ 

Markfltack to point to the CKlt code of the 2' 
procedure that Invoked it, until the desired 
procedure ia found. 



tf at any time the ^aved IPC of naln 
body of Che operating syatQn Is about to 
be changed, give an eitecucion error. 



E 
E 



SYSTEM SUPPORT PROCEDURES 

Hoce: See the Apple Paacal Language Reference Manual for a iwre detailed 
description of these jirocedures- 



Byfe-Array Procedures 



PLC 



155 Ifl 



i 
1 

1 



SCN 



158 11 



MVL 



15a a: 



HVR 



i5e ai 



1 



FIllchflr(d3t , len, char)* Tos tchar) 
Is the source character. Toa-l (Ion) la the 
nuuiber of bytes in the destination array 
which are to be filled with the aource qhar. 
Tdb-Z (dflt) is a byte pointer to the firat 
hyte Co be filled In che desclnatlon PACKEP 
ARRAY OF CHARacters. Copy the character 
from toB Into tos-l characters of the 
deBtlnacion array* 

Scan(inaKd]sp, mask, char, start, forpast). 
ToB (forpascj is a cwo-byte quantity fijHually 
the default Integer 0) which Is pushed, but 
later discarded without being used in this 
implementation. Tos-l (start) Is a byte 
pointer to che first character to be 
Bcanned In a PACKED ARRAY OF CHARacters- 
Tn6-2 (char) la the character against which 
each scanned character of the array Is to be 
checked. Tos-3 (mask) Is fl l£ the check is 
for equality^ or 1 If Che check Is for 
Inequality. Toa-^ (raaxdlsplacement) gives 
the Ttiaxioiuiii nuoiber of characters to be acanned 
(scan to the lefc if nesacive). tf a character 
check ySeida TRUE, push che number of 
charactera scanned {negative, if scanning to 
the left}* If Diandisp la reached before 
characcer check yields TRUE, push msxdlap . 

Hovelef t tsrc, dsC, numbytes). Toa 
(nLimbyteB) gives the number of bytea to nuue. 
Tdb-I tdst) 1b a byte pointer to the 
destination array's firat byte which will 
receive a moved byte- Toh-2 (arc) is a byte 
pointer Co the source array's flrsc byce wlilch 
will he moved. Copy toa bytea from the 
source array to the destination array, 
proceeding to che rlahl chroujjh boch arrays. 

Hover] ght(src, dst , numbytes)* Toa 
(nuiDbyces) gives the nuniber of bytes to move* 
Tos-J (dst) is a byte pointer to Che 
deatination array's first byte which will 
receive a moved byte. Tos-2 (src) is a byte 
pointer to Che source array's first byte which 
vlll be moved. Copy tos bytes front Che 
snurce array to the destination array, 
proceeding Co che left through both arrays. 
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Compiler Procedures 



BFI 



"DtS 



213 



1^5 00 



IDS 



156 07 



Breakpoint, Hot eibqiJ (nets as a NOP); 
intended for future debugging rouHnen- 

TrPpsearchCfpp, fcpZ, name). Tos-I (fcpi 
13 a byte pointer to the race of a binary tcee 
ToH inane) Ja a hj/te pointer to a Ltiraclou 
which concaina the addreEB of gn a-characcer 
nann? Chat you wish to find or Co place in the 
tree^ Search che tree, looking for a record 
wlch Cho required name- Scars Che addresa of 
Che IflBt node viaited. on completion of Che 
search, into the location paJnted to by 
byce painter toa-l (fcp2), and push the 
result of the aearch; 

^ if the laat node waa a record with 

the search name, 
1 If Che search name should he a new 
record, at caching Co che lasc tree 
node by ihe Right Link, 
-1 if the search name should be a new 
record, attaching to the last tree 
node by the Left Link. 

Thin la an ae a emhly- language hlnary tree 
search uaed by the Compiler. Ic ia faat. hue 
does NOT do type checking on Che parameters. 
The binary tree uaes nodes of type 



CTP 



RECORD 
MAME: packed array [U.fl] OF CHAR; H 
LLIHK, RLINK: "CTPj "" 



□Cher tnfonnation 

END: 



I 



Idsearch, Uaed by the Compiler Co parse K 
reserved worda and idenClfiers- 



)CIT 



NOP 



1 
1 
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I Miscellaneous 

r i 

I 

I § 

I 1 



2U 



215 



Time- Pap cuo pointers to two Integers, 
and place Jn those Integern a 32-blC 
Indicatiun of Che current ClTne. {Since 
che Apple haa no ceal-Cime clock, this 
instruction acts as a NOP- Apple sets 
bath Integers Co ^era>) 

Exit the operating ayatem. Do a 
"cold boot" of the syacein, like the 
operating ay a tern's H(alt coinmand. 

No operation, SomeClTiiea uaed to reserve 
space in che code for later addlcions. 



i 1 



244 APPLE RASCAL OPERATfNG SYSTEM 



i 4 



ARCHITECTURE OF P-MACHINE 245 




.i 



E - 






E =i 



APPENDIX B 



OPERATIO 



J^B INTRODDCT(ON 

2ii9 THE SVSTI^ COD£FILE 

Z4H ^tgiKnts 

2<;^ A CotlcLlLp on Olflkette 

250 The S<fgQicnt Dl^ilojiary 

251 A Ptocerfure Uiciionary 

252 A FrDc<jduro Coilo Section 
254 SY^JTEM HEMORV USH 

254 Apple 11 Memory >1iip 

256 The Proeiam StJtk 

2S8 Ari A<ll jaLion Record 

2&D Mnrc on tlie I'rngfam Stack 

260 OVERV:£W 

260 SuDBnary of the Ylgurcfl 

363 "The Program" 



CHINE 



E § 
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INTRODUCTrON 



I 



The Apple Fasiidl aysccra Jfi a vecHion of the UCSD Pascal Hyatem^ which 
fa an Interprecec-bastd inipleinenCiitlon of Pascal, This meaQH chat tho 
t^QUipUer emits code for a "PseudD-machi ne" or "P-'raachinfl" which la 
emulated an run time hy a program written In the machine lanRuaae of the 
host- For the Apple, Chla P-macUlne emulation pragram is the 
Interpretec, wrlttep in the Apple's 6502 machine lanBuace and found in 
the boot diskette's file SYSTEM-APPLE , 

The Apple Paadfll operatinfi aystein and various utilitieg are themselves 
written in Pascal and run on the aamti interpreter- Thus the entire 
system can be moved Co d new host machine by rewriting Che Incerpteter 
fof tlie new hogt- Every host computer operacinfi under a version of UCSD 
Pascal has an interpreter that makes Che host computer "appear'', from 
the viewpoint of a program beinft executed, to bt? this aame P-Tiiachine- 
Thla appentllx deacrJbeg Che "run-time" or "execntlon-time" environmenc 
of the Appli? Pascal P-machine, For itiore information about chn 
"hardware" of the P-machJiie, see this Dkanual'a previous appendix 
AftCHlTECTlIRE OF THE P-MACHIWE. 

At the end of this appendix la a skeleton version of a large Pascal 
projiraiii, referred to chroufihouC the appendix as "The Program"- The loflln 
body of this appendix is a top-down description of "The Proarflm"'s 
diakette codeffle, and its execution under the Apple Paacal ayatera- 

We will make occaflional uae at a helpful coincidence: "The Program" 
briefly sketchEs out a very early veraion of the Apple Pascal operating 
systeiQ. The current Apple Pascal operating system has been extended 
and cUanj;ed in many waya from "The Program" shown in the examples. 
However, this will not prevent you from understanding the (Dechani&mH 
of the P-jnachlne's operation, which are accurately deacribed. 
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THE SYSTEM CODEFILE 



SEGMENTS 

If "lite Frogcam" ware eKpandad Co the complete Apple Pascal operaclnB 
BystEu, It wjuld cDiislat □£ at least 1^,900 llnea □{ Pascal and compile 
to more Chan 100,000 bvtea of code — Just a hit eod big to fit all ac 
oncE liiCo Che nnsioorir oF an Apple. Ihecefore, "The Pcograni" la overlayed 
oslns "segments", which let you axpllLicly partitiDn a progcatii Into 
poirclons, only some of uhich need he resident In ioatn mEioary ac a time. 
See the Apple Pascal Language Keferance Manual far details about 
aegmenCs. 
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Segments used within a prograra pnrtion rauat be declared before the body Jb [ ]ft 
of the outer program portion- To let an inner segment call an outer- "^ i -^ 



program procedure, the outer program portion can declare the called 
procedure l''DRWARl) before declaring the segment. An example of this 
appears in "The Program", i^ere the segment procedure COMPILEH uses the 
outer program's procedure CLEARSCREEN> wfilch was declared FORWARD- 

^e^enting a program does not change its neaniag in any fundamental 
sense- When a segment procedure la called (for instance, line A of "The 
Prugram" calls the COMPILER segment procedure), the interpreter checks 
to see it that segment la already on the program stack, due to a 
previous (and still active) invocation of the segment- If it ia , 
control is transferred and execution proceedsi if not, the appropriate 
code segment must be loaded onto the program stack from disk before the 
transfer of control takes place- When no more active invocations of the 
segment exist, ita code is removed from the program stack. ?or 
Instance, in "The Program", the code for the COMPINIT segment ia not 
present on che stack either before or after tue execution of line A. In 
fact, the COMPINIT Segment is only present on the stack during the 
execution of "The Progrnm"'s line B- 



A CODEFILE ON DISKEHE 

The diskette codcfile reuultlng from compilation of "The Program" Is 
diagramined in Figure l- The codeflle consists of a segment dictionary 
followed by a aet^uence of code aegments. The main program generates one 
code se^ent, and each segment procedure generates another code 
aejiment. The ardering of code segments (from low address to high 
address) is determined by the order that one encounters segment 
procedure bodies In passing through "The Program"- 



hlgh diskette addresses 



Segment 


trz 




PASCAL SYSTEM 


Segment 


tm 




EDITOR 


Segment 


tf3 




COMPILER 


Segment 


1/2 




COMPINIT 


Segment 
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USER PROGRAM 



Code 
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— Segment 
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FIGURE 1 



low diskette addresses 



COMPLETE CODEFILE OF "THE PROGRAM" 
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Each code segment beglne on a baundacy betueen ±[Bk.eCte blocks {the 
512-byte disk allocation quautuni used by the Apple Pascal operating 
systeoi)- Each segment may occupy inany, faany blDclca; the code for these ^k 
sej^mencs la only hinted at In the mich-abbrevlaCed version ahown Jn "The ^F 
PrLjgEaci"* ^E 



tn 



high diskette addresaefi 



* Ad ovBEVleu of the relationship beChreen Figures I through 7 

(to be dlflcuased In the following pages) 1b given In Figure 6 at 

the end of this appendix- It Is helpful Co study Figure S at this 
point for a better underatandlng nf Che following aectiona. 



THE SEGMENT DICTIONARY 

The segment dictionary, in Che first block o£ a codefJle, contains an 
entry for each code segEQent In Che file fthe mflin program is assigned 

aegnent ff?J. The entry incLudea the aegnienc's ai^e (in bytesj and its 
disk location. The dlak location la given as the nuraher of blocks to 
the beginn-ing of the code segment, relative Co the beginning of the 
aegmcnt dictionary (which is also che beginning of Ch*- codefile). This 
InforioaElon la kept in the aystem communications area faiao called 
SYSCOMi see thia manual's appendln, ARCHITECTURE OF THE P-MACHINE) 
dutlnij Che Execution of the codefile, and is uaed in the loading of non- 
present segments when they are needed- The segmenc dictionary also 
contains information about the code and data segments of INTRINSIC UNITf 
which the program USES- This loanual's appendix, FILF FORMATS, gives a 
more detailed account of the Information in the segment dictionary. 



A CODE SEGMENT 
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Figure 2 Is a detailed diagram of ''The Prograin"'s Seeraent fl0, containing V 
Che code for the main prngrani segment, PASCALSYSTEM. Each code segment 
contains Che code for Chat segmenC's outer block, as well as the code 
for each of the (non-aeguient ) procedures within that segments Obaerve 
thaC CLEAHJiCKEblN is the firsC main-program procedure for uhlch code ia 
generated and that it appears at the beginning of Che segmenC The 
outer block code, uhlch la generated lasc, appears latit in the code 
segment. Following the code for the various ptocedurea ia the code 
segment's procedure dlcclonary* 
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Number of procedures | Segment number 

In this segmenc | of this segment 



Procedure til PASCALSVSTEH | 


Procedure #2 CLEARSCREEN | 


Procedure ft2 \ 


rest of 
procedure dictionary 


1 


^====...===================. 


===V=aSBB 


PROCEDURE #1 (outer block of 
PASCALSYSTEMJ 


code 1 


J Other procedures in 
1 segment PASflALSYSTEM 


code 1 

code 1 


1 PROCEDURE S2 


code I 


1 PROCEDURE &2 (CLEARSCREEM) 


code 1 



Procedure 
Dictionary 



Procedure 

Code 

Sections 



lotf disketCe addresBea 



FlGURi: 2 DETAIL OF THE "PASCALSYSTEM" CODE SEGMEPJT 



A PROCEDURE DICTIONARY 

Each procedure in a code aagment is assigned a procedure number, 

starClng at 1 for the ouFier block (Che main program or a segment 
procedure), and ranging as high as IA9 ' All references Co a procedure 
are niade via iCa numhet' Translation from a procedure's number Co the 
location of Chat procedure's code in the code segment is accomplished 
with the procedure dictionary ac the end of Che segment. This 
dictionary Is an array indeiced by Che procedure number. Each array 
element is a self-relative pointer Co Che code for the corresponding 
procedure- Since lero is not a valid procedure number, Che zoro-th 
eutry of Che dictionary is used to store the number of Che code segment 
(even byte) and the number of procedures in that code segment (odd hyte) 
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A PROCEDURE CODE SECTION 



t a 



r 



A more detailed dlaEram of the cade aectloo for a single procedure 
tflthld a. code aeBment Is seen Jn Fifiure 3- That figure shows the cade 
flection for procedure CLEARSCREEN, Id "The Frograin^"a mdln-program code 
aegraent, PASCALSYSTEM, Each procedure's cade secClon consists q£ two ^e 

pacta: the procedure code Itself (In the lower portion of che section) V 

tlifl procedure- These attributes are: 



and a table of attributes of 



LEX LEVEL: Odd byte- Specifies the depth of absolute lexical 
nesting for the procedure- (E-g', the Leu Level (LL) of 
PASCALSYSTEM ■■ -1, LL of COMPILER or CLEARSCREEN - Q _ 
LL of COMFINIT - 1 , etcO 

PROCEDURK HUMBEit! Even byte- Relera Co the number given to this 
procedure In the procedure dictionary of Che parent code 
segiQent. For example, CLEARSCREEN Is Procedure S2 {see 

Figure 2). 

ENTGH IC: A self-relative pointer to the first InBtrucClon Co be 
executed for this procedure- 

EKIT IC: A Be If -relative pointer to the beginning of the block of 
procedure instructions which oiuBt he executed to terminate 
procedure properly* 

PAHAMETER SIZE: The number of bytes of parametEra pasHcd to a 
procedure from Its caller- 

DATA SIZE: The size of the activation record (see the later 

sections of this appendix for details) in bytefl, excluding 
the Markacack and PARAMETER SIZE. 

Between theae attributes and the procedure code there niay be aa 
optional section of nteinory called the "jump table". Its entries are 
addresses within the procedure code. JTAB Is a term commonly applied 
to the aix attrlbutea Just discussed and the Jump table itself. JTAB 
is also one of Che system registers, which points to the attributes 
and Jump table section of Che currently executing procedure. 
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high diskette addreHaes 
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FIGURE 3 



DETAIL OF THE "CLEARSCREEN" PHOCEDURE CODE SECTION 
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SYSTEM MEMORY USE 



APPLE II MEMORY MAP 

Figure 4 is a skeCch of the Appie Il'a meraocy, when ninnlna under the 
Appit PaHcal QperaElng system. 

This raiemary jnap Js apeclf Jc to Che Apple II, and doea not apply to any 
other computer. It ia provided for your curiosity only: a priiuary 
tdak of the tranciporEahlc Apple Pascal ayatein ia to eliminate the 
neoeSBlty £or tiie prograimner to know anyching ebout apeoific memory 
addreaaes and uae* 

The Apple Pascal file SYSTEM. PASCAL roughly correspondg to "The 
Pro£ram"'s resldeni: code segment named PAStALSYSTEM aa discuaaed 
chroujihouc this appendix. 
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Address (Hex) 
64K (FFFF) 

52K £D3»aj 
4AK U000J 



24K (6000) 

3K icm) 

.5K tlFI^J 

0K (BMB) 



Apple Language Card 



SYSTEM. i* AS CAL (Part 2) 



fiVSTEM. APPLE 

P-code - 

Interpreter 
(written in 6502 code) 



Apple 11 Main Board 
I/O Expansion ROM Space 



I/O Device Addressoa f, KOMh 

SYSCOM 

SYSTEM. PASCAL (Part 1) 
The Operaclng System 
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Hlgh-Rea Graphics, Page I 
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Zero Page Pascal System Use 



(Language Card) 
f 

< — >| Monitor ROM 



< — >\ Interpreter 

I BIOS I/O RouClneH 



< — KP (Tcsp of 

A Program Stack) 



(Free 
Memory) 



V 
■c— NP 



(Top of Heap) 



SP (Top of 

Evaluation Stack) 



FIGURE i* 



MEMORY MAP OF THE APPLE II 
WHEN USING APPLE PASCAL 
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THE PROGRAM STACK 



tpa 



Figure 5 is a snapshoc of user raeraory, showing the Pascal progtam stdck E ' ^ 
In aome detail, during Che esecution of a cgll to proceduce CLEAHSfRFFTJ ' 



- „-.. „ „, T. prpceduce CLEAHSCREEN 

trom Ihe frograiE s line C, In segment pratodure COMPINIT- 



high menLory addreasea 
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The pascal heap is at the loweat part oi memory available to programs; 
it GEous toward M gh loeiiiary. It is used to store dynamic variables, 
text files used ty the Editor^ and other data. The system 
communications area (also called SYSCUM), Is at the top o£ memory, above 
the aystera's resident code segment- SYSCOM is accessible both to 
a EH embly- language routines in the interpreter and (aa if it were part of 
the stack) and to system routinea coded in Pascal- SYSCOfl serves as an 
important coumunication link between these two levels of the system (for 
mare details about SYSCOM, see this manual'fl appendix, ARCttlTECTURE OF 
IHE P-MACH1«E)- 

The program stack, groHln^ dovn from high memory, la used to store three 
types of items: 

1- A Code Segment for each active program segment (see Figures 
i, 2, and 3J and for each active UNIT. 

2m An Activ:ition Record containing local variables and Markstack 
parameters foe escb procedure activation (see Figure 6)- 

1. A Data Segment for each INTRINSIC LWIT which requires one, 
loaded un the progtacn stack Just before the code 
segment for that UNIT- 



When Sflgflient procedure COMPINIT Is called in line fl of "The Program", 
CUMFINIT's code segment (which includes all the compiler initialization 
procedures) is loaded onto the program stack- The COMPINIT activation 
record is then bkiilt on top of the program stack. 



FIGURE 5 DETAIL OF USER MEMORY DURING EXECI/TlON 

UF PHOCEDUltE "CLEAHSCREEK" 
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Consider the staCuB ot operatlonB In COMPILER, just ag GOMPlNIT la 
called In line B- The syacein regJatGrs (see thla mnual's appendlji 
AKCHITECTURE OF THE F-MACHINE) coiitaJn the followlna: 

SP: evaluation Stack PoJnrer. Polnta ta thp current top o£ 
the evaluation stack. 

KP; program acacK. Pointer. Points to the current top of the 
program Htaclt, Juat beyond COMPILER'S activation cecard- 

IPC: Interpreter Fro^ram Counter- Points to the next COMPILER 
iDBtrLictlan, Inoedlately following line B, 

SEG: SEGment pointer- PolnCfi to the COMPILER code seEiciant'a 
procedure dictionary. 

JTABi Jimip TABle pointer. PolntB to Che table of attributes 
1q COMPILEli'g procedure code lection* 

MP: Mackfltack Pointer- Points to the Markatack in COMPILER'S 

flcElvatlon record. Used to find varlableB local to COMPILER, 

The call to procedure COhtPINIT cauBea the operating conditions which 
existed In the aysten reaiaters, just at the time of COWPILEK'fi call to 
COMPINIT, Co be stored In COMPIJIIT'a Hjirkatflck In the following mtinner: 

Scored In these 

COMPINIT Harkacack fields 

MSSP {MarkScack Stack Pointer) 
MSIPC (MarkStack Interpreted 

Program Counter) 
MSSEG (MarkStack SECment pointer) 
MSJIAB (MarkStack Jump TABle) 
MSDYTJ (MarkStack DYNamlc link) 

In addition, the MarkStack STATic link field (MSSrAX) becomes a pointer 
to the activation record of the lexical parent of the called procedure- 
In particular. It points to the MSSTAT field of the parent's niarkstack. 
In this examplE, COMPINIT'e MSSTAT is made to point to the MSSTAT field 
compiler's MarkStack. After building the new procedure'a activation 
record on the program stack, new valupa for the system regiaters SP, IPC 
SEG, JTAB, and MP are eaCabllshed for the new procedure. 

If the called procedure has a lex level of -1 or Q, the f^ontenta of 
register HASH are saved on the evaluation stack, and a new value for 
EASiL 1b calculated. Finally, KP la saved on top of the program stack, 
and a new value for KP is calculated. Those elements are not part of 
Che COMPINIT MarkStack or activation record- 
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at COMPINIT call 




SP 


^*— ? 


IPC 


> 


SEG 


.J 


TTin 


.__> 


MP 


^^~> 



t 
r 

E 

i 
i. 

E 

i 

r 

t. 
t 



-^ 



AN ACTIVATION RECORD 



Xi Figure fi Is a dlagr 
-^ stack for COMPINIT. 
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am of the activation record uhlch Is placed on Che 



high memory addresses 
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Other COMPINIT variables 
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FIGURE 6 DETAIL OF THE "COHPINIT'' ACTIVATION HEmRD 



In Che upper portion oE the acClvaClon record, space Is allocated tor 
Variables local to the new procedure- For example, COMPINIT'fi 
activation record allocates 9pai^e for Integer variables 1 and J, as well 
aa boolean variable BOOL- 

Note Chat In thii^ e^z^mple no apace Is needed for passed parameters 
because none were passed ED this procedure. If parameters aze passed, 
they occupy space after the last local variable. If the procedure la a 
function, space Is also reserved (foLloulng the last passed parameter] 
for storing the function's returned value- 

The lower portion of the acCivaclon record Is called a "MarkaCack" (also 
sometimes called a Mark Stack Control Word, or MSCW) , When a call to 
any procedure is made, the current values of the system registers, which 
characterise Che operating environment of the calling procedure, are 
stored In the Mcrkatack of the called procedure. This allows the system 
registers Co be restored Co pre-call conditlora when control la 
reCurned to the calling procedure- 



258 APPLE RASCAL OPERATING SYSTEM 



e i 



OPERATION OF P-MACHINE 259 



When the gall to CLHlAftatlBEEK 1b madE in line C of ^'The Program" 
another flCClvaclon record Is added to the pro^rflm aCaok- Once au^in rh 
register values and the a[iprapriace Statlt Link are scored Jn the new ^ 
Markatflck (in CLEAR.SCHEEN ' s activation record), and che aygtem 
reglficers are then updated. Note Chat the new StG no longer points to 
Che COMPINIT Begment'a procedure di ctlnnary, hut to the procedure 
CL^SC^EN)!" "^^ F'^CALSYSTEK code Beg-nent (whl^h contains procedure 

No code sesment for CLEARSCBEEN Is added to the pragraiB stack before 
building Che activation record, since the code for CLEARSCREEN is 
already preeent on Che prograni Btack, In the code aegment for 
PASCALSfSTErt, The invocation o£ CLEAHSCREEN causes only an activation 
record to be added Co Che program stack. When CLEAftSCREEW and COMPINIT 
are completed, the COMPILER activation record vlll aflali. be the top 
elenjenc on the stack- 



MORE ON THE PROGRAM STACK 

Figure 7 is a more detailed dJaBram of Che program stack during 

execution of an Instruction In CLEARSCREEN , includlnfi appropriate 

pointers for Static and Dynaraic Links of CLEARSCREEN's ^]a^kBtack, Note 

where che system registers poinc In the pcogram stack. In particular 

JTAB points to the table of aCtrlbutea In the CLEARSCREEN procedure code K 

section which Js In the PASGALSYSTEH code segment, IPC points to the » 

next instruction Inside that CLEARSCREEN code, and SEC points to the 

base of the FASCALSYSTEM code sGEoient's procedure diccionarv. SP points 

Cq Che top of Che evaluation stack, which la not shown in this diagram, B 



OVERVIEW 



SUMMARY OF THE FIGURES 



Figure B lllustcateH a top-down process hy showlnfi the relatlonshlpj 
among Figures ] through 7- 
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"THE PROGRAM'' 

ThlH is "The Progcaci", various parts of which ate used es exaoiplea 
throughout thlfl appendix- fls mentioned In the introduction, "The 
Program" ahows Juat Che partial skeleton of a very early uersJon of 
the Apple Pascal operating ayatemi. Much of Che code is only hJnCed 
at» and many of the segments used In the current version of the Apple 
Pascal operating system are mlsalng entirely from "the Program". 



PROGRAM PABCALSYSTEMi 

VAR 

SYSCOM! SYSCOMHEC; 

CH;CHAR; 

PROCEDURE CLEARSCREEN; FORWARD; 

SEGMENT PROCEDURE USERPROGRAH; 
BEGU 

t * V 

END; 
SEGMENT PROCEDURE COMPILER; 
VAR 

SY, OP i INTEGER; 

SYMCURSOR: INTEGER; 

PROCEDURE INSYMBOL; FORWARD; 

SEOiEHT PROCEDURE CQMPIMIT; 

VAR 

1, J [INTEGER! 

BOOL: boolean; 

BEGIN 



I:-l; 

CLEARSCREEN; <- 
INSYMBOL; 

EHD; 

PROCEDURE LVSYMBOL; 
REGIS .-. Ejm; 

PROCEDURE BLOCK; 
HEOIN , , , END i 
BEGIN t*COMPILER*) 
- - ■ 

COMPWIT; <- 

INSYMHOLj 

« « A 

END; (*:]OHPILBR*) 



-Line C 



-Line B 



(continued on next page) 
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SEGMENT PROCEDURE EDlTORj 
BEGIN .-• END; 

PROCEDUBS CLEAR SCREEN 

BECIN 



WRITE C 

BEGIN <*PAaGALS¥STEM*) 
REPEAT 

READ(CH)j 

CASE CH OF 

'C'lCQrtPlLER; 
'E':EU:TOBi 

'U':LJSERPROGRAH 

END t*CASE*) 
UNTIL CH = 'H' 
END. 



0; 



Line A 
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TEXT FILES 



At the befilnnlng of each ceitr file la a 10?4-byce (two blocfca, on 
dlakecce) he^di^r page, which contains Information Eor the use at the 
text editor' Thla apace is reserved for use by the text editor, and is 
t-eHpeL:ted by all portions o£ the syatem- When a user program opens a 
TEXT file, and REWRITES or RESETh Jt with a title ending in ,TEKT the 
I/O aubaygtein will create and aklp over the Initial header page. This 
la done to facilitate users editing their input and/or output data. The 
file-handler will transfer the header page only on a dlsk-to-disk 
transfer, and will oodt It on a ttanafer to a serial device Uhus 
transfers to PRINTER:, and CONSOLE: uJll omit the header page)- 

Followlng the initial header page, the text itself appears in subsequent ^B 
lfl24-byte text paaes (two blocks each, on diskette), where a text paee 



t 



1e defined: 



[DLE] [Indent] [text] [CR] pLEj [Indent] [textl [CR] », anullfl] 

die's {Data Link Escapes) are followed by an Indent-qode, which la a 
byte containing the value 3Z+(nuiijber to indent)- The nulls at the end 
of the page follov a [CH] In all cases, and are a pad to the end of a 
lli24-byte page {because the compiler wants Integral numbers of lines 
on a page). The Data Link Escape and corresponding indentation code 
are optlona.!. In a given text file, some lines will have the codes, 
and aome won't- 



DATA FILES 



The forinatB Cor Data files are up to the user. 



CODE FILES 



Codeflles may contain up to 16 segments* Block 9 of a codefile 
contains Inf armatlon regarding naicie, kind, relative address and length 
of each code segment- Thla Informacion ia called the "aegmenc 
dictionary" and Is represented as a record: 

RECORD 

DISKINFO: ARRAYia.,151 OF 
RECORD 

CQDELENG, CODEADDR: INTEGER 
END; 

SEGHAHEj ARRA¥|0.,|5] OF PACKED AREAY[a.-7] OF CHAR; 

SEGKIND: ARkAV[0..J3] OF tLINKED.HOSTSEG, SEGPRDC.UNITSEG, 

SEPETSEG jUNLXNKED^ITJTHlWS , 
LINKED_1NTRIMS,DATASEG); 



■ 
i 
i 
i 

E 
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4 



TEXTADDR: ARRATrfl.-15] OF TTJTEGERi 

SEGlNFOi PACKED AflKAi: Itf-a^l OF 

PACKED RECORD 

SEGNUM: 0-.255; 
HTYPE: fl.-l3i 
UNUSED; 0.-lj 
VERSION_: a-.7 
ENDi 

INTRIBS__SEGS; SET OF 0.-31; 

t* library Information: format undefined *) 

COHMENT: STRING 
END; 

ret la an atrty of sixteen word-palra, each word-pair describing one 
ginent of code. CODELENG and CODEADDR give. ce3pectlvely» the length 
the code Hcgraant in hytes, and the blocli addreae of the code aegmenc 



The first and aecond word In the first block constitute the firat wotd- 
palr, which describes the block-location and length of code segment d> 
Segment contains Che outerioodt code for the main program. Subsequent 
aegmencg contain the code for the program's uarJous aegnient procedurea 
and regular Units (if anyj, In the order of their appearance In the 
program. 

Following this wird-palc array is an array of arrays of charactera. 
Thla Is an array of slKteen eight-character arrays which describe the 
segments by nanB- These eight characters are those which Identify the 
main program anJ its segment procedures at compile time. 

Following the array of names is an array, again sixteen words long, 
of state descriptors. The values In this array Indicate what kind of 
aeEment (SECKINU) la at the deaccihed location. The values for this 
array, at preaent. are: LINKED. HOSTSEG. SEGPRGC, UNITSEG, SEPRTSEG. 
UNLINKED LNTRINSIC, LINKED INTRINSIC, and DATASEG. A deacrlptlon of the 
segments corresponding to various SEGKINDa follows: 



LINKED 



A fully executable code segment. Either all 
external references tUNITs or EXTERNALS or -REFh) 
have been resolved, or none were present. 
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HOSTSEC ThD outer block of a Faacal pCGgrani, If the 

program has ExteEiLsL ireferenceH. 

SECPROC A Pascal SE^gjufnT: pcocedure tnot ua^d}' 

UNITSEG A compiled regular UNIT . 

SEPRTSEG A separately compiled procedure or functioTi. 

Aaacmbly language codefUes are alwaya ot this 
type. 

UHL1NKED_INTRINS An INTRINSIC ITKIT cdntalnirt§ unresolved 

calls CO aagenbly-languflge procedures or functionn. 

LINKED_1NTR1NS An INTRINSIC UNIT in its final, ready co-run 

DATASEG A specif Icatlor for the daCa aegmenc associated 

vUh An INTRINSIC UNIT, telling how many bytes Co 
allocate and vhich QcgmfnE to use- 
Sec Che Apple Pascal Laoguage Reference Manual for iDore lof annation 
about Paflcal SEGMEPfTs and UNITs. 

AfCer the array of q^gmenL kinds la an array of sixteen integers. If a 
segmeEit is a regular or InCrlDelc Unit, Che value of che cocresponding 
array element gives the relative block number (TEKTADDR) where Che 
Interface potclon of that Unit heglna. Array elementa corresponding to 
ncm-UnlC segments have Che value £ern< 

Next is an array of sluteen words CSEXJINFQ), each word describing one 
flegnenC of code- BiCs Chrough 7 Ethe righCmeBt blls) of each word 
specify the scgrenC number for Chat code Regnent- This apeclfies Che 
sloe number the code segment will occupy in the system's SEGTABLE, at 
execution time. Rica B through 11 identify che "Hflchine type" which 
Cells what kind of code is present in Che code aegmant. Those machine 
types are assigned as follows: 

Unidentified code, perhfipa from a previous canpller- 

1 F-code, moat signlClcant byte first fpoaltive byte aex) . 

2 P-code, least aignlflcant byte first fnegative byte seji). 
A atream of packed ACCTl characters flllB tha low byte of 
a word firBt. then the high byte. This la the kind of 
P-code used by the Apple- 

3 chrough 9 Aaaerablad machLoe code, produced from a saembly- language 

Cext. Machine type 7 identifies machine code for Apple's 
6502. 



E 
I 
f 
E 
f 
i 
i 



i 



E ^ 

Ei ii 

E ^ 

E^ i 

& i 



BiC 12 (UNUSED) in each word la an unused filler, usually set Co zero* 
BlCfl 13 chrough 15 tdenCify Che version number of the ayatem; currently 
ChlS Is HEt Co the number one. 

Next are Cwo uorda (INTRIWS_SEGSJ ChaC Cell Che ayatem which Incrinslc 
UnlCs are needed in order to execute the codefile. Each Tntrinalc Dnlt 
la SYSTEM >LIRRAl^Y la Identified by a segment number (or tuo segmenc 
nunbera, If Che InCrtnaic Unit has a daCa aegment). Each of Che thirty- 
Cwo bite In INTHINS_SEGS corresponda Co one of che chlrty-Cwo poaalble 
Intrlnalc Unit tegment numbers. If the n-Ch blc la aec Co 1, Chls 
Indicaces the program will USE Che Incrinalc Unit whoae segment nuoiber In 
SYSTEM. LIBRARY ia n . 

Library Inforination of undefined format occupies raoet of the remainder 
of the segment dtcdonary block. The "copyright" CexC supplied by Che 
Pascal Computer SC opclon may appear ac Che very end of the block- 
The accual code segmencs begin Jn block 1 of che codefile* The Incernal 
format of codeflle eegnents is shown in aome detail In the first portion 
of this manual'6 appendix, OPERATION OF THE P-MACHINE- See that 
appendix for more details about codefile aegments- 

For an unlinked code segment (that is, a segment, containing unresolved 

exCernal references) the Compiler generacea Linker information which 

hegina at the flret block boundary following the last segment of code. 

This InfomiatioTi is a series of records, one for each 

UNIT, routine or variable which la referenced in, but not defined In Che 

source. The firat eight words of each record contain the followlrig 

Informaclon: 



LITY?£S - (EOFMAHR, UNITREF, 
GLOBDEF, PUBLDEF, 
SEPFUNC, SEPPREF, SEPFRE5) j 
LIENTBY-RECORD 

NAME: ALPHA ^ 

CASE LITYFE: LITYPES OF 
UNlTHEt', 
GLDBREF. 
PUBLREF* 
PBIVREF, 
SEP PREP, 
SEP FREE, 
COKSTBEF: 

[FORMAT: OPFORMATi 

NREFS: INTEGER; 



GLOBREF, PUBLHEF, PRIVREF, CONSTREF^ 
CONSTDEF, E?n'PROC, EXTFUNC, SEPPROC, 



NWORDS: LCRANCE) ; 
GLOBDEF: 

(HOMEPROC: PROCRANGE; 

ICOFFS£T:ICRANGE); 



(format of lientry*aame can be 
any of BIG, BYTE or WORD ) 

fnumber of refs to lientry.nane 
In compiled code segment) 

(size of prlvacea in words) 



{which procedure iC nccurH in) 
{b^te offset in p-code) 
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POBLDEF; 

(flASEOFFSET: LCRAHGE); (canpi ler-flaalgntd word ofEfletJ 
COHSTDEF: 

{CONSTVAL! INTEGER); (user's defined value) 

EXTPflOC, EXTFUNC, 
SEPPftOC, SEPFUNC^ 

CSHCPROC; PROCH^JJCEj (procedure number tn aource aeg) 

MPAilAHS: IWTEGERij {number of parameters expected) 

EOEWARK; 

CNEXTBASELC: LCftANiJE) (private var allocation Infa) 
END(llentry); 

If the LITYPE Ig one of Lbe first case varfaotH, then folloving this 
portion of the recurd is a Hat of polnterfl Into the code segment- 
Each of these pointers Is the absolute byte address wlthJn tbe code 
aegment of a reference Co the variable, UNIT or routine named in Che 
llentry. These are eight-word records, but only the first NBEFb of 
thein are valid- 
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When tD Use -XEXT and -CODE 
Lans'i9ge ^ysteai Diskette Filea 
Pascal I/O Device VoIurvq 
Apple I/O Device Slots 
EnecutloD Errot Messages 
1/0 Error Hesaagea 
6502 Aaaenblec Error Hesaa^eS 
ASCII Charectcf Codes 
F-Mdchlne Op-Codea 
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WHEN TO USE .TEXT AND .CODE 



t -^ 



An Apple Pascal fllennme nornally endfl ulch a "suffix" that tella the 
Byecem something about the contenCa at that file* The neat comniDn 
suffixes are .TEXT , for Elles cDntalning teur (natural Iflneuage, 
Faflj^fll pragcam text, or 6503 aaBeDibiy-language text), and .CODE ^ for 
tiles containing cade tcoiuplled P-code or asBembled 6502 machine code) 



E 



Many Apple Paecal coamanda deal with varloua diskette files that you nuiat 
specify hy filename. In those inscancea where the file being acted on can ^e 
be cf only one type (-TEXI , .CODE , etc. ) the system allows you to type W 
the filename either witb or without the suffix- If you fotRet to add Che 
suffix, the aystem will add It for you. In those inatancea where a 
Cdflimand may apply co fileg of QKre than one file tvpe, the following Br 

rules fipply: K 

1. Several Filer cojieands which must dJatlnguifth between textCilesB 



and codefllea will use Che given filename esactly as typed, wlrhout 
adding any suffix for you. These coimnanda are: T(ranBfer, MCake, 
Cfhange, and Rfemove. 

2. The S(ave caminand automBClcally supplies the coftect suffix 
(.TEXT or .CODE ) to the veralon of the workfile being Staved. 
Therefore, when using thla command, don't specify a suffix. 

3- Code segments may be scored in library fllea which have either 
»COUE or .LIBRARY as their suffix- Cotmnands that use theae files 
must specify the auEfix, These Include the Librarian utility's 
OUTfUT CODE FILE, and the Pascal Compiler's nse-Labrary 
("^Ufiienane*) control option- 



i 

E 
E 
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LANGUAGE SYSTEM DISKEHE FILES 

The following table shows which files ere normally found on each of the 
Langkiage System Dlakettea needed for Apple Pascal. The ORDER of Che 
files on any dlakette Is unimportant- Wlien inoHt files arc needed by the 
system, It is only necessary that the file be present on ANY dIakeCte In 
ANY drive. For exceptions Co this rule, sec the DISKFILES NEEDED 
sectionH of thia Manual's chapter THE COMMAND LKVEL. 



Diskette 



SYSTEM. 

SYSTEM. 

SYSTEM- 
SYSTEM, 

SYSTEM. 

SYSTEM. 
SYSTEM. 

SYSTEM. 



PASCAL 
MI SC INFO 

CO:iPlLEEi 

EDITOR 

FILER 
LIBRARY 

QUE SET 
SYNTAX 



DlakettE 
APPL31: 



SYSTEH 
SYSTE?1 
SYSTEH 

SYSTEM 
SYSTEJl 
SYSTE^l 

SYSTE>1 
SYSTE.^ 



APPLE 

PASCAL 

MISCINFO 

.EDITOR 
. FILER 
.LIBRARY 
. CHARS £T 
. SYNTAX 



Diskette 
APPLE 2 : 

SYSTEM. COMPILER 

SYSTEM. LINKER 
SYSTEM. AS SMBLEK 
6 5 00 -OPCODES 
b 500, ERRORS 



Diskette 
APFLE3: 

SYSTEM. APPLE 
FORMATTEK.CODE 

FORMATTER. DAT A 
LIBRARY. CODE 

LIBMAF.CODE 
SETUP. CODE 
BINDER. CODE 
LALC, CODE 
LINEFEED. TEKT 
LINEFEED. CODE 
SOHOCGOTO.TEXT 
SOROC GOTO. CODE 
SOROC. MISCINFO 
HAiELGOTO,TEXr 
HAXELCOTO .CODE 
HAZEL.mSClNFO 
CRO S SHE F. TEXT 
CROSSREF.CODE 
SPIRODEHO.TEXT 
SPIRODEHO.CODE 
HI L BERT. TEXT 
HIL BERT. CODE 
GRAF DEMO. TEXT 
CRAP DEMO. CODE 
GBAFCHARS.CODE 
GRAFGHARS.TEXT 

TREE. TEXT 
TREE. CODE 
SAL AN CED. TEKT 
BALANCED. CODE 
DISKIO.TEXT 
DISK 10. CODE 
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The next portloo of the table glvea moEe inf onoflClon about Che Various 
files prov:l<Jed vlch Ctae Apple Pascal syatEmi 



n^ 



•^ SYSTEW.AKEHBLEK 6502 Assembler 



i'i leaane 



SYSTEM. APPLE 



SYSTEM. PASCAL 



SYSTEM -HI SCIMFO 



SYSTEM. EDITOR 



SYSTEM. FXLER 



SYSTEM. LI BRAKY 



SYSTEM. CHARS ET 



SYSTEM. SYNTAX 



CfinteaCB of File 



Interpretetj 
urlccen in 6502 
laadhlne langujige 

Conmaad level 
portion of 
operating system 



Use of File 



Executes P-code 
□a Apple's 6502 
process Of 

Lets you pick 
E(dit, F£ile, 
RCuDi etc. 



iDforinaEion about Telia sysEem 
[erminal in use about Cetmlnal 

hfirdware 

Letfl you make 
& change text 

Lets you store, 
delete & cDve 
disk files 

Many programs 
use these 
library 
couClnes 



Text Editor 



Filer 



Routines for l/O, 
lotig integers, 
trig- funi:t]onE, 
graphics, etc- 



Array providing 
upper £ lower 
case griiphJc 
character set 

Compj Ler error 
mesHages 



Lets you put 
text UD 
graphics 
screen 



:; ^ 



When File Weeded 
Power-on, HCalt ^ 

pQuer-on, H(alt, ' ' — " 
It£S£T, 

ICnltlallze, p^ 
every return .* 

to Coiraiand 
level 



Power-on, H(alt, [ J 
RESET, 
UniClallBB ^ 

I I 

Efdlt, C(ODipIle t I 

R(un, A(5sei&ble 



F(ile 



I ] 
t ■ 



Rfun, K{ecute, J ' 
L(lnk» CtoDiplle, 
if library 

fouCines are r~l 

u»«d [ ; 

Used by WCHAR 

h WSTRINC in ■ | 

TURTLEGRAPHICS [ * 



Provides loeaaage K(un, C(oppile | \ 



SYSTEM. COMPILER Pascal Compiler 



SYSTEM. LINKER 



Linker 



Id ECditor 
after Compiler 
finds an ercoe 

Cod verts Pascal, 
program text 
to P-code 

Puts library 
routines into 
your program 



followed by 
E<diE after 
an error 

CComplle, R(un 
Lflnk, R(un 






t! 



6500. OPCODES 
65 00. ERRORS 



FLJRMATTEk-CODE 
FORMATTER. DAT A 

LIBRARY. COPE 



LIBMAF.CODE 



SETUP. CODE 



SOROC.MZSCINFO 



EUZEL.MISCINPO 



BINUER.CODK 



SUROCGOTO-TEXT 
S OHO CCUTO. CODE 

ELUELGOTO.TEXT 
EAZELGQTO.CDDE 

CALC.CODE 



LINE FEED. TEXT 
LINEFEED. CODE 



Instruction set 
for Aflseidiler 

Assembler error 
Taeaaages 

Utility prograiQ 

Utility program 

Utility program 

Utility program 



SY STEM. MISC INFO 
for Soroc IQ1Z0 
terminal 

SYSTEM. MISC INFO 
for Ha^eltint! 
13(10 teriDinal 

Utility program 



GOTOXY procedure 
for Soroc 1Q12B 

GOTOKY procedure 

for HflZeltlne 1500 

Utility program 



Utility program 



Converts &502 
aBsembly text 
Into machine code 

Used by Che 
Asaemhler 



A(saeiiible 



A(s3emble 



Provides message A(ssemble 
afti^r Assembler 
flnda an error 



Formats new 
diskettes 



X(ecute FORMATTER 



Puts new routines X(ecute LIBRARY 
Into library 

Reveals contents X(eeuCe LIBHAP 
of library file 

Hakes new file X(ecUte SETUP 

SYSTEM.MlSCIrtFO 
for use uith 
external terminal 



EllDLlnstes SETUP 
for using a 
Soroc 1Q120 

Eliminates SETUP 
for using a 
biazeltlne 13410 

Hakes new file 

SYSTEM -PASCAL 
with COTOXY for 
external terminal 

Used with BINDER 
for Soroc igl20 

Used with BINDER 
for Haaeltlnc 3500 



Xfecute BINDER 



Lets you divide, X(ecute CALC 

multiply, add & 
subtract number a 

Removes linefeed Xtecute LINEFEED 
normally sent Co 
printer after RETURN 
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CROSSREF-TEXT 
CROSSREF.CODE 

SPlROLtinU.TEXT 

SPI»iUDHMU,CODE 

HILBEBT.TEXT 

HIL BERT, CODE 

GHAfDENU.TEXT 

GRAtDEMG.tOUE 

GRAFCHAKiJ.CODB 

GkAtXHAKS-TEXT 

TREE. TEXT 

TKEE. CODE 

BALANCED, TEXT 

BALANCED. CODE 

DZSKIO.TEXT 

DISKIU-COUK 



These are a collection o£ small 
demoaBtratlan proaranfl, llluacrflL f ng 
variDUB ledCures of the Apple Pascal 
language- The firpt 5 pairs af files 
Bhov exainpleE of using the Apple Pascal 
graphics feaCurea, The next 2 pairs of 
fJIea ahow a almple "tree" algorithm for 
sorting data. The laat pale of files 
is a brief enample of using randtun-access 
disk fUes, 



Each pair of flies conalats of a ,TEXT 
version which you can read In the Editor, 
and a -CODE veralon you can X(ecute. See m— 
the Apple Pascal Langua|>e Reference Manual W 
far more Inf onnntion about these files. "^ 



= § 



APPLE I/O DEVICE SLOTS 



In using an Apple computer wlCh the Apple Pascal operating syHtem, 

the Apple's peripheral equIpmeTil slots are assigned as follows; 



PASCAL I/O DEVICE VOLUMES 



Thie Apple Pasical operating syatem as 
to the various input/output devicaa 



Voluuie 

VufLiher 


Volume 


<I0; 




#ii 


CONSOLE: 


fli 


SYSTEBM: 


n; 




Hi 


<iilsltette aaiiie>: 


#5; 


<diBkette najikc>: 


H; 


PRINTER : 


#7i 


KEtllN: 


#8: 


REMOLfT: 


Wt 


^diskette naDie>: 


#I0f 


^diskette name^: 


nu 


<dlsk.ette ruine>: 


#13: 


<dlskette naiiie>< 



signs vuluuie numbers and voluise names 
aa follows; 



Description of 
Input/Output Device 



g 1 



(not used) 
Screen & keyboard (echo on input) ■ 
Screen i- keyboard (no echo on input] 



g i 



(not uaed] 

Boot disk drive (slot 6, drive 1) 

2nd disk drive (slot 6, drive 2) 

Printer (card in elot 1) 

Kenote input 

(card in slot 2) 
Remote output 

Sth dlak drive (slot /^, drive 1) 

6th disk drive (slot f*, drive 1) 

3rd disk drive (slot 5, drive 1) 

Ach disk drive <slot 5, drive 1) 
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Apple Input/Output Device and Card 
Slot Aaaigned to That Slot 

Apple Language Card * 



Printer fCoinmunl cations Interface 
Care, Serial Interface Card, or 
Parsllel Printer Interface Card) 

Modem, Apple"to-Apple communi cation, 
etc. (Comnunicat Ions Interface 
Card or Serial Interface Card) 

External terminal (Communi cat Ions 
Interface Card. Use of Serial 
Interface Card la tolerated. ) 



Apple Pascal 
Operating Syatem Dee 

Stores Interpreter 
and I/O aystBO 

PBlNTERi or ff6: 



REMIN: or 07'. 
REMOUT: or Jfl: 



5tJi disk drive (Drive 1} 

6th disk drive (Drive 2) 

(Difik Controller Card) 



3rd disk drive (Drive 1) 

Ath di3k drive (Drive 1) 

(Disk Controller Card) 

Boot disk drive (Drive 1) * 
2nd diak drive (Drive 2) 
(Diak Controller Card) 

Muat not contain a disk drive 
(Do not inatall a Disk 
Controller Card here.) 



Apple keyboard and acreen 
(only If tliere is no 
Coomuni cat Ions Interface 
Card in slot ^3) 



CONSOLE! or ffl; 

(with echo cm input) 

StSTERM! or tf2: 

(without echo on input) 

diskette name: or fl5! 
diskette name: or tfl0: 



diskette name: or #11: 
diskette name: or #k2: 



diskette name: or S^i 
diskette name: ur ^3; 



CONSOLE: or Bl: 

(with echo on input! 

SVSTERM: or ffli 

(without echo on input) 



Note: An asterisk f * ) Indicates a device which la REQUIRED tn be 
present in that slot* 
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for 
ads 
tuslng 
not 



Hoce: It Is posEibte to use the Apple Fflscal operating syaten vdth 
Apple conq^Qter systGio containing unly a alngle ±lfik drive, 

Note: IE a Connitual cat Ions Interfnce Card is Installed in slot it"^, 
use with an eitternal terminal, hoDtJuE the aystem automat Jcally la 
Che Apple Pascal operating aystem into a different area of memnry 
some Gf tho Apple's teHt-screen memory). This happecia whether or 
the external tecniniil is actually connected to the Communl cations 
Interface Card- To return to uaing the Apple without the external 
terminal I you must Cum off the Apple's power switch, remnve tlie 
Comijunlcaclons Interface Card froni slot #3, and Cum on the Apple' 
power again to re-booc the aysteiD. 



EXECUTION ERROR MESSAGES 

When a program or any portion of the Apple Faecal operaClnB fiyfltem 1q 
running, txecutlon errors are reported by number or by message. In one 

of Che following forma: 



EXEC ERR S 11» 

SIf I, P* 7, U 56 

TYPE < SPACES TO CaWTITJUE 



TO ERROR; VOL NOT FOUND 

sa U PH ?■ I* 56 

TYPE <SPACE> TO CONTINUE 



1 


Bi 


E 


^ 


E 


^ 


r 


§ 


E 


i 



E i 



where St specifleB the program's current eegment nunkber, Pff specifies 
the procedure number within Chat Begment, and If specifies the byte 
number In that procedure where the error uaa detected- User I/O etfota 
£onXy) ere reported in the more detailed second form only if file 
SYSTEM. PASCAL la in the boot drive at the time. 

See this manual's section on Error llandUn^, In the appendix 
AhCHITECTURE OF THE P-MACHlNE, for more details- Also see the Apple 
Pascal Language Reference Manual's dlecusslon of Che L+ fcomplled 
listing) con^iler option, which describes how Co list BegmenC , 
procedure^ and byte number information when you compile a progrsni- 



Error Error Message Fatal 

Number and Description Error? 

System error of undefined nature- FATAL 

1 Invalid Indexi value out of range for string or 

subrange IXINVKTX). Does not occur if R- compiler 

option used> 

2 No Eegment! bad code file (XNOPROC)- File reads 

corr&ctly from disk, but not a valid BEgmenC> 

3 Procedure not present at exit Clme (Xh'OEXITJi eiilt 

from a procedure that was not previously called or 
active* 
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19 



11 



12 



13 



14 



15 



SCflck overflow (XStKOVRl; the program ntack and the 

heap together have exceeded available user memory- 
Integer overflow (XltJTOVR). Integer arithmetic gave 
a result Mb bits. Long integer arithmetic gave an 
InCermedlaCe result >2b digits or final result wae 
assigned to variable of laaufflclenE sl^e. 

Divide hy aero {XDIVZERJ . 

Invalid memory reference <bua timed out> (X0ADHF-M) : 
foot used on the Apple) > 

■Jaer break (XUBREAK): "break" key pressed 
(CTRL-^, on the Apple). 

System I/O error (XSYIOER) : error in attempting FATAL 
to read an operating system seenent from disk. 

Jaer I/O error tXUlOERR); error when user's program 
attenqited a hlockread, blockwrJCej get, or put. 
If file SYSTEM. FASCIAL available, this error is 
further reported as an I/O ERROR {see next page). 

JnlTHplemented instruction (XNOTIMP) : op-code not 
implemented, or CSP to non-eKlatent routine- 

Floating point math error (KFPlEHR)! error in reel 
number format, overflow, underflow, etc. 

String too long (XS2L0KG): attempt to eCote a 
source atrlng into a destinaClon string of 
insufficient size. 

Halt, Breakpoint (without debugger In core) (XHLTBPT) ; 
[not used on the Apple}- 

Bad Block fnot used on the Apple; Apple reports 
I/O EKRDA ffhftt insteadj. 



A fatal error either causes Che system Co "cold boot" itself or (if the 
error was totally lethal to the system} forces you Co "cold boot" the 
system by turning the Apple off and Chen on again* All other errors 
cause the systen to re-lni tlall^e Itself fdo a ^arm boot" hy calling 
system procedure INITIALIZE), usually after you press Che Apple's 
spacebar to continue- 
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I/O ERROR MESSAGES 



Eccnr 


Erroc liessage 


Number 


and Description 


tf 


No 8CC0C 



II 

12 

n 

14 
15 



Dlskecce has bad block: parity error {CRC). 
{Nat uaed on Che Apple>) 

Bdd device (voIliqie) number* 

Gfld mode: illegal operacion' (For example, an 
flctenyt to read from PRINTER: O 

Uadeflned hardware error- (Mot used on the AppLeO 

Lost device! device la no longer on-line, after 
aucceteCully atflcting an operation oaing that 
device- 

Lost Zilei file ia no longer in the dlsketca 
directory, fl£ter Guccesfifully starting an 
operation using that flle> 

Bad title: Illegal £ilertame> (Far example, 
flleaame is acre than L5 characters long.) 

No room: insufficient space on Che specified 
diskette. (Files nuat be stored in contiguous 
dlBkette blocks.) 

No davlce; Che specified volume Is not on-line- 

[to file: the specified file Is not in the directory 
of the specified volume- 

DuplIcaCe file: atti-ii^C to re-uri te a file ^en 
£ file of that name already exists* 

Not qloaed: attempt to open an already-open file- 

Not open: attempt to access a closed file- 

Bad format: error in reading real or Integer- 
(For exanple, your program expects an Integer 
input but you typed a character-} 

EUng buffer overflow: charatters ace arriving at 
the Apple faster than the input buffer can 
accept then- 
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16 Urlte'-protect error; the specified diskette Is 

wri te-protected . 

64 Device error: failed to complete a read or urite 

qoTcectly (bad address or data field on diskette) 



The appropriate cne of these 1/0 error messages Is given when execution 
error [JiU occurs (see previous paee}» If the file SYSTEM. PASCAL is In 
the booL drive* See the Apple Pascal Language Reference ftanual for 
Information about the Apple Pascal function lOHKSULT, which returns the 
error numbers shewn above- 



6502 ASSEMBLER ERROR MESSAGES 

^ben the 6502 AaBeoihler discovers an error in your assembly- language 
routine, it nlves an error message taken frorn the file 6^p0.ERgaKS , 
usually found on diskette APPLE2: . If the file b500,ERHOliS ia not 
available in any drive, errors will be reported by number, only. 

The 6Sfl2 ABHembltr error mesaage corresponding to each error number 
is given in Che table below. Some people may prefer to gain some 
additional diskette space by removing the file 6500. ERRORS and using 
this table instead. 

The first portion of this table lists all the general error messages. 
tLachine errors specific Co Apple's 6502 are found in the last portion 
of the table - 



GENERAL ERRORS 

1: Undefined label 

2: Operand ouc of range 

3: Must have procedure name 

^; Kumbi^r of parameters expected 

3: Extra garbage on line 

6: tnpul line o^'er 60 characters 

7: Not enough .IF's 

H: Must be declared in -ASECT before uaqd 

9: IdenliEler previously declared 

10: Improper format 

11: .EgU expected 

12: Must .EQU before use if not co a label 

13: Macro Identifier expected 

14: (ford addressed machine 

15: Backvard .ORG currently not allowed 

16: Identifier expected 

17: Constant expected 

Id; Invalid atructure 
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19: Extra special symbol 

20: Branr:h too far 

2li Variable not PC relative 

11: Illegal macro parameter Index 

23: Nat enough ciaiiro [laraiaetera 

24: Operand not abaolute 

Z3: Illegal uae af special aymboLa 

26: Ill-formed aiiprasfilon 

27: Ngc enough operands 

26: Cannot handle this relative expreaaion 

29: Constant overflow 

30! Illegal decimal constant 

31^ Illegal cecal conEtant 

32: Illegal binary constant 

33: Invalid key word 

3A: Macro stack overflow; 5 nested liioit 

35; Include files aiay not be nesLed 

36: UneKpected end of Input 

37: This Is a bad place for an -INCLUDE file 

3&- Only labels & commerLtB nay occupy columD 1 

39: Expected Local label 

Ait: Local l^bel stack ovErflov 

41: String constant must be on one line 

42: String constant exceeds B0 characters 

43: Illegal use of macro paramecer 

44: No local labels in .ASECT 

45: Expected key word 

46: String expected 

47: Sad block, parity error <CRC) 

46: Bad unit number 

49: bad [Qode» illegal operation 

50: Undefined hardware error 

51: Lost unit, unit 1b no longer on-line 

52: Lost file* file Is no longer In directory 

53: Bad tltle» Illegal file name 

54: No room, Insufficient space on disk 

55; No unit, no Bucb volume on-line 

56: No file, no such file on volume 

57: Duplicate f Jle 

5B: Not cloBod* attempt to open an open file 

59: Not openi atceoipt to access a closed file 

60: bad forniati error in reading real or Integer 

61: Nested macro definitions Illegal 

62: '-' or '<>' expected 

63: May not ■EQU to undefined labels 

64: Must declare -ABSOLUTE before lat -FRDC 



B -^ 



-^ 65tf2-SPECrFlC EHROkS 
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76: Index register required 

77; 'X' or 'V expected 

76: Zero-paae address requited 

79: Illegal ues of register 

30: Indfx register expected 

81; Ell-formed operand 

82; 'K' expected far Indexed addressing 

83: Must use 'X' Index register 



ASCII CHARACTER CODES 
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Hex 


Char 


Dec 


Hex 


Char 
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Hex 


Char 
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Hex 


Char 
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^]IIL 


32 


20 


SP 


64 


40 


@ 


96 


60 


h 


1 


01 


SOU 


33 


21 


i 


65 


41 


A 


97 


61 


a 


1 


02 


STX 


34 


22 


'1 


86 


42 


S 


98 


62 


b 


3 


0:1 


EIX 


15 


23 


If 


67 


43 


C 


99 


63 


c 
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04 


EOT 


3b 
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66 


44 


D 


100 


64 
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EtJ(J 


37 


25 


% 


69 


45 


E 


101 


65 


e 


6 


0b 


ACK 


33 


26 


& 


70 


46 


F 


102 


66 


f 


7 


07 


BEL 


39 


27 


' 


71 


47 


G 


103 


67 


6 


8 


0H 


B3 


40 


26 


\ 


72 


48 


H 


104 


66 


h 


9 


09 


JTT 


41 


29 


) 


73 


49 


I 


J05 


69 


1 


10 


0A 


LF 


42 


2A 


A 


74 


4A 


J 


106 


6A 


J 


11 


0H 


VT 


43 


28 


+ 


75 


4B 


tt 


107 


6B 


k 


12 


0C 


FF 


44 


2C 


* 


76 


4C 


L 


103 


6C 


1 


13 


0D 


CR 


45 


ZD 




77 


4D 


H 


109 


6D 
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14 


fl£ 


SO 


46 


2E 


■ 


78 


4E 


N 


110 


6E 


n 


L5 


0F 


SI 


47 


2F 


/ 


89 


4F 





111 


&F 





16 


10 


DLE 


46 


30 





80 


50 


P 


112 


70 


P 


17 


11 


DCl 


49 


31 


1 


81 


51 


q 


113 


71 


q 


IS 


12 


DC2 


50 


32 


2 


82 


52 


R 


114 


72 


r 


19 


L3 


DC 3 


51 


33 


3 


83 


53 


s 


115 


73 


s 


20 


14 


DC 4 


52 


34 


4 


84 


54 


T 


116 


74 


t 


21 


15 


NAX 


53 


35 


5 


35 


55 


u 


117 


75 


u 


22 


16 


SYN 


34 


36 


6 


66 


5& 


V 


lie 


76 


V 


23 


17 


ETfl 


55 


37 


7 


87 


57 


w 


119 


77 


V 


24 


[8 


CAN 


55 


36 


S 


36 


58 


X 


120 


76 


X 


25 


l^ 


EI-1 


57 


39 


9 


89 


59 


¥ 


121 


79 


y 


26 


lA 


SUB 


58 


3A 


; 


90 


5A 


z 


IZZ 


7A 


z 


27 


IB 


ESC 


59 


36 


I 


91 


5H 


i 


123 


7B 


{ 


26 


IC 


FS 


60 


3C 


< 


92 


5C 


\ 


1Z4 


7C 


1 


29 


lu 


GS 


61 


3D 


a 


93 


5D 


J 


125 


7D 


} 


30 


IE 


RS 


62 


3E 


> 


94 


5E 


" 


126 


7E 
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n 


IF 


[|£ 


63 


3F 


1 


95 
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127 
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DEL 
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P-MACHINE OP-CODES 



D£C 


Sex 


Hn^mcinic 


Dec 


^ex 


Mnemonic 


Dec Hqx 


Wneraonlc 





n 


SLPC 














1 
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n 


SLPC L 














126 


- 

7E 


SLDC 126 














127 


7F 


SLDC 127 


170 


AA 


5AS 


213 


D5 


BPT 


12B 


80 


ABI 


171 


AB 


SRO 


214 


D6 


K.IT 


129 


til 


ABR 


172 


AC 


XJP 


215 


D7 


NOP 


L30 


b2 


ADI 


173 


AD 


RNP 


216 


DB 


SLDL 1 


13L 


Q2 


ADA 


174 


AE 


GIF 


217 


D9 


SLDL 2 


132 


64 


LAND 


175 


AF 


EqU 


218 


DA 


SLDL 3 


133 


65 


DIF 


176 


H0 


GEQ 


219 


DB 


SLDL 4 


I3& 


86 


DVI 


177 


BI 


GRT 


220 


DC 


SLDL 5 


ns 


S7 


DVR 


178 


B2 


LDA 


221 


DD 


SLDL 6 


136 


88 


CHK 


179 


B3 


LDC 


222 


DE 


SLDL 7 


n? 


&9 


FLO 


180 


B4 


LEQ 


223 


DF 


SLDL 8 


I3fl 


8A 


FLT 


181 


&5 


LES 


224 


E0 


SLDL 9 


139 


&11 


INN 


182 


B6 


LOD 


225 


El 


SLDL 10 


140 


ac 


INT 


183 


87 


NEQ 


226 


E2 


SLDL 11 


141 


8D 


LOP 


184 


SB 


STR 


227 


E3 


SLDL 12 


142 


S£ 


MODI 


185 


B9 


UJP 


228 


E4 


SLDL 13 


143 


SF 


IlPI 


186 


BA 


LDP 


229 


E5 


SLDL la 


144 


9fl 


MPH. 


187 


BB 


STP 


230 


E& 


SLDL 15 


U5 


91 


UGl 


188 


BC 


LDH 


231 


E7 


SLDL 16 


146 


92 


HGR 


189 


8D 


STM 


232 


E8 


SLDO I 


147 


93 


LNOT 


190 


BE 


LDB 


233 


E9 


SLDO 2 


140 


94 


SRS 


191 


BF 


STB 


234 


EA 


SLDO 3 


149 


95 


Sfil 


192 


C0 


1>T 


235 


Efi 


SLDO 4 


L50 


96 


SBR 


193 


CI 


RBP 


235 


EC 


SLDO 5 


151 


97 


SGS 


194 


cz 


GBP 


237 


ED 


SLDO 6 


152 


98 


SQL 


195 


C3 


EQUl 


238 


E£ 


SLDO 7 


153 


99 


syB 


196 


C4 


GEQI 


239 


EF 


SLDO B 


154 


9A 


STO 


197 


C5 


GRT I 


240 


F0 


SLDO 9 


155 


9B 


IAS 


198 


C6 


LLA 


241 


Fl 


SLDO 10 


L56 


gc: 


UNI 


199 


C7 


LDCI 


242 


F2 


SLDO 11 


157 


9D 


LDE 


200 


GB 


LEQI 


243 


F3 


SLDO 12 


I5S 


9H 


CSP 


201 


G9 


LESl 


244 


F4 


SLDO 13 


159 


9F 


LDCN 


202 


CA 


LDL 


245 


F5 


SLDO 14 


160 


A0 


ADJ 


203 


CB 


NEQI 


246 


F5 


SLDO 15 


161 


Al 


FJP 


204 


CC 


STL 


247 


F7 


SLDO 16 


162 


A2 


INC 


205 


CD 


CXP 


24B 


FB 


SIND 


163 


A3 


IND 


206 


CE 


CLP 


249 


pg 


SIND 1 


164 


A4 


IXA 


207 


CF 


CGP 


250 


FA 


SIND 2 


165 


A5 


LAO 


208 


D0 


LPA 


251 


FB 


SIND 3 


166 


A& 


LSA 


209 


Dl 


5TE 


252 


FC 


SIND 4 


167 


A7 


LAE 


210 


D2 




253 


FD 


SIND 5 


168 


AB 


MOV 


211 


D3 


EFJ 


254 


FE 


SIND 6 


169 


A9 


LDO 


212 


D4 


NFJ 


255 


FF 


SIND 7 
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COMMANn LEVEL 

FTLEH 

EDITOR 

COMPILf^ 

ASSFMBLfiR 

LINKER 

ITtlLITIES 
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OPERATING SYSTEM SUMMARY 2B5 



OPERATING SYSTEM 



ThE following commands am available at all lavels of the gyisteiii: 

CTHL-A Shows the other 4ii-character ''page" of screen display, 

CTRL-Z Causes C3ie display ic follow the curscr tight and left, 

CTKL-@ "Break" algnalj does a "warm baot". 

CTRL-F Stopti program output to the screen or prJntei: until the 

next CTRL-F, wlttiouC stopping the program- 
CTRL-S Temporarily stops any prograni or proceSEs, On the next 

CTRL-S , the program tondlnue^i > 

HESET Does a "warm boot". 

Power off-on Does a "cold boot". 



COMMAND LEVEL 



1. The CoDiDand level Js reached autoiiLatlcally, each tine the iyiten la 
l>ooted, RESET, or Initialised- It Is also reached when any progr^Lik, 
including any part of the operating system. Is termlnated- 

Z> Use the Conuiand level options to Select any of tht; main eubdlvlaloim 
of the Apple Pascal operating system- 



These are the Command level options; 






F<ile 
ECdit 
C(ouipJle 
A{5seii]hle 

Ltlnk 

X(ecufe 

RCun 

D{ehug 

U{aer-reB 
Unltlflll 
H£alt 



tart 



Ceals with the disks and disk fileii< 

lielps you crtrste and change text fJlea- 

Converts Pascal prograia text Into executable P-t:nde 

Converts 6307 assembly text Into b502 machine code. 

Combines external routines Into a Pascal program- 

Loads and runs a utility program or other P-code Zi 

Executes the workfile. autontatlcally compiling and 

linking fir^t, If necessary^ 
Not implemented; do not use this option- 

Re-executeH the last projiram or option executed- 

Does a "warm boot", like pressing RESET- 

Uoes a "code boot", like turning the power on. 



m 



u 



le- 



u 



13 
id 



FILER 



L- From Command level, select E-'(11er- When FILER prompt line appears, 
you may remove your boot diskette, if necessary. 

2. Uae Filer conmandB to dove, save, and erase the workfile and other 
disk EUea- 



Theae are the Filer comndndar 

T(ransfer Copies a file or entire diskette to another diskette or 
device. Source diskette must be in a drive to begin. 

M(ake Creates a dummy fjle on dlskette- 

tChanse Renames a file or diskette, 

Biemove Ecases a file from Its diskette directory. 

K{riinch Packs all files together on a diskette, 

Ztero Erases a directory and renames the diskette. 

G(et Designates a file to be used as the next wnrkflle. 

Sfave Saves the workflle on diskette. 

N(ew t:leflr3 the wotkflle. 

W(hat Tells the original name of the current uorkfqle- 

V(oliiiDes Shows which devices and diskettes are in the ayscem- 

LHst-dlr Shows what files are on a diskette, 

E(xt-dlr Shows what files are on a diskette, giving acre information, 

B(ad-blks Testa diskette informatiim for correct recording. 

XEaiuIne Tries to fix Informatlcm reported bad by B(ad-blks. 

P(reflx Sets the default volume name' 

D(ate Sees the current date- 

y(ult Leaves the Filer and returns to Conrnand level. Be sure 
your boot diskette is In the boot drive. 



sa 
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EDITOR 



1. From Command level, select Ctie F(iler, Start a H(ew file or G(pt 
an old file for re-edlting £one-drlve note; flrsi T(ransfer the 
old file onco your boot diskette)- QCuiC the Filer. 

!• From Comniand level, aeLecr Che Efdltor, PrcsH the RETURN key l£ 
you are beginning a new file. Use the Editor coinmandfi to itnserti 
DCelete, Xfchange, and move text* When you are through, OCuiC and 
U<pdate the uorkflle. 

?■ If this Ls a prograni, yaii may R.(uq it now, Belfast steps 2 and J 
until Che program runa correctly* 

A, From Ehe Comniaiid levelt select the Fdler, S(ave the uorkfile- 



fi I! 

I. a 



These arc the Editor conEiiands: 



J(unip Moves cursor to flLe's BteginnlrLg, E(nd, or preset Mfarker- 
P(age Moves cursor one page. 
F{ind /xf Moves cursor to next "x'^. 

tfnaert Inserts typed text at cursor* 

D{elete Moving curHor eraEes text* 

Z(ap Ei-ases ail text from cursor to start of last FCind, 

H(eplacD, or iCnaert. 
C(opy Inserts Bfuffer flast Insertion or deletion) or 

diskette F(lle at cursor* 
X(chBiige Replaces character at cursor by typed character- 
R(eplace /x/Zy/ keplacea nest "k" by "y" ■ 

Afd]ust Kovet line at cursor right and left- 

M(flrgin ForniatH all text between two blank lines (one paragraph)' 

S(et Places a M(srker at cursor, or sets E(nvicDtiment iTptlons 
for Afuto- indent, F(illlng, margins, etc, 

V(erlfy Redisplays screen wirh errors gone* 

Q(uiC Leavea the Editor. You may l](pdate the workfile, ECxit 
without updating, W(rite to any diskette file 
before returning to Comiaand level or S£avG to your 
originel f lie* 






COMPILER 



i- From Conmand level, select H(un or C(ai'^lle- 

2- If a text workflle e>!igtg, that file la compiled automatically. 
Otherwise, you aie prompted to specify a source textfile and then 
CO specify a deatlnetion codaflle. 

3. If Che Compiler finds an error, select Che Efditor to fix lc< 



ASSEMBLER 



^i !■ From Command level, salecc ACssemble- 



2. If a text workfite exists, that file ia assembled aatomatlcally. 
Otherwise, /ou are prompted to specify a source tejitfile and then 
to specify d destination codeflle- 

3. Finally, you are prompted to specify an output te^Cfile for the 
assembly listing, If you want one, 

A. It chs Assenbler finds an error, salecC Che ECditor to fix IC 



UNKER 



U From [Jommantl leval, select Rfun or L(inlc. 

2. R(un links the con^jlled workfile to UfJITs and routines found in 
SYJsT EM. LIBRARY, automatically- L(ink prompts you to specify a 
host cndeflle and then to specify as otany library codefilea ae 
needed. Preas the RETURN key to stop giving library files- 

J- Next, you are prompted to specify a map textfile for storing Linker 

information. Normally, JuaC press Che RETURN key to go on- 

'i- Finally, you are prompted Co apeclfy an output codeflle for Chs 
linked prograiu. 
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UTILITIES 



!■ From t^ominand level, aelecL cJie Xtecuce opElon- When yau are 

pcoDipCpd JilXECUTE WHAT FILE?, typo the name at a utilJty program. 

2m The utility prDgCanui enable you to foriTiat new diakeCtes^ put 

routines into a llbrarj' file, change Lhe Hyetem to use an external 
tecmina-l,, change printer output, and use your Apple as a calculator. 



These are the Utility prograns: 

FOKtiATTHK Prepares neu diskettes for use by ^pla Pascal. 

LIBKARV Puts UNITE and routines Into & library file. 

LlfltlAP Shows Che contenta of a library file. 

SETUP Changes the syateiD for use with an entetnal terminal. 

BINDER Changes the system for use with an exLernal terjolnal. 

LINEFEED Stops the sendlnt of linefeed after RETURN to printers. 

CALC Leta you add, subtract, divide, and multiply numbers- 
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-ABSOLUTE , A^Heinbler 

directive 161, 173 
actlvflClon cecord 25fl-260 
addrj?aa field 25 
A(djuHC , 

Editor coDUQflnd 113 114, 126 
APPLESTUFF , IntrlnGlc Unit 176 
APPLEU, cQPtents af 273 
APPLEl, contenta of 273 
APPLE2, contents of 273 
APPLE3, contents of 273 
architecture, P-machine 22*1-2^5 
ASCII charactet code 283 
-ASCII , ABsenfljler 

directive 159, 173 
Afsaeinble , 

outer level cooiinaiid 17, 136 
Aflsembler, IZb-W^ 

dltecclvea 157-172 

directives, sunMflry 172-17A 

dlakfllea needed 13, 136-137 

ecrec cneGGages 281-232 

ejtample 142-150 

intcaductlon 136-138 

linkage to aEBerobly 
routines 155-156 

EUDOndr}' 289 

ayntax of fllej, 151 

syntflM of BtatefiienCfl 152-155 

use 138-150 
assembly file specif li:atioQ 

syntax 152 
astecisk 

And Pftoftx comouind 65 

as apeciflcfltlan far 
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